sp_OAGetProperty(Transact-SQL)

  • 아티클

OLE 개체의 속성 값을 구합니다.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

구문

sp_OAGetProperty objecttoken , propertyname 
    [ , propertyvalue OUTPUT ]
    [ , index...]

인수

  • objecttoken
    이전에 sp_OACreate를 사용하여 만든 OLE 개체의 개체 토큰입니다.

  • propertyname
    반환할 OLE 개체의 속성 이름입니다.

  • propertyvalue OUTPUT
    반환된 속성 값입니다. 지정되는 경우 반드시 적절한 데이터 형식의 지역 변수이어야 합니다.

    속성이 OLE 개체를 반환하는 경우 propertyvalue는 반드시 int 데이터 형식의 지역 변수이어야 합니다. 개체 토큰은 지역 변수에 저장되면 다른 OLE 자동화 저장 프로시저에 사용할 수 있습니다.

    속성이 하나의 값을 반환하는 경우, 지역 변수에 속성 값을 반환하는 propertyvalue의 지역 변수를 지정하거나 단일 열 단일 행의 결과 집합으로 클라이언트에게 속성 값을 반환하는 propertyvalue를 지정하지 마십시오.

    속성이 배열을 반환하는 경우, propertyvalue가 지정되면 NULL로 설정됩니다.

    propertyvalue는 지정되었으나 속성이 값을 반환하지 않으면 오류가 발생합니다. 속성이 두 개 이상의 차원을 가진 배열을 반환하는 경우 오류가 발생합니다.

  • index
    인덱스 매개 변수입니다. 지정되는 경우, index는 반드시 적절한 데이터 형식의 값이어야 합니다.

    일부 속성에는 매개 변수가 있습니다. 이러한 속성을 인덱싱된 속성이라 하고 매개 변수를 인덱스 매개 변수라고 합니다. 하나의 속성이 여러 개의 인덱스 매개 변수를 가질 수 있습니다.

    [!참고]

    이 저장 프로시저의 매개 변수는 이름이 아니라 위치로 지정됩니다.

반환 코드 값

0(성공) 또는 0이 아닌 수(실패)이며 OLE 자동화 개체가 반환한 HRESULT의 정수 값입니다.

HRESULT 반환 코드에 대한 자세한 내용은 OLE 자동화 반환 코드 및 오류 정보를 참조하십시오.

결과 집합

속성이 한 개 또는 두 개의 차원을 가진 배열을 반환하면 배열은 결과 집합으로 클라이언트에게 반환됩니다.

  • 1차원 배열은 배열 내 요소 수만큼의 열이 포함된 단일 행 결과 집합으로 클라이언트에게 반환됩니다. 즉, 배열이 열로 반환됩니다.

  • 2차원 배열은 배열의 첫 번째 차원에 있는 요소 수만큼의 열과 두 번째 차원에 있는 요소 수만큼의 행이 포함된 결과 집합으로 클라이언트에게 반환됩니다. 즉, 배열이 (열, 행)으로 반환됩니다.

속성 반환 값 또는 메서드 반환 값이 배열인 경우에는 sp_OAGetProperty나 sp_OAMethod가 결과 집합을 클라이언트에게 반환합니다. (메서드 출력 매개 변수는 배열이 될 수 없습니다) 이러한 프로시저는 배열의 모든 데이터 값을 검색하여 결과 집합의 각 열에 알맞은 SQL Server 데이터 형식과 데이터 길이를 결정합니다. 특정 열에 대해서는 이러한 프로시저에서 해당 열의 모든 데이터 값을 나타내기 위해 필요한 데이터 형식과 길이를 사용합니다.

하나의 열에 있는 모든 데이터 값이 같은 데이터 형식을 공유하는 경우에는 해당 데이터 형식이 전체 열에 대해 사용됩니다. 한 열의 데이터 값들이 여러 다른 데이터 형식을 가질 경우 전체 열의 데이터 형식이 다음 표를 기준으로 선택됩니다.

 

int

float

money

datetime

varchar

nvarchar

int

int

float

money

varchar

varchar

nvarchar

float

float

float

money

varchar

varchar

nvarchar

money

money

money

money

varchar

varchar

nvarchar

datetime

varchar

varchar

varchar

datetime

varchar

nvarchar

varchar

varchar

varchar

varchar

varchar

varchar

nvarchar

nvarchar

nvarchar

nvarchar

nvarchar

nvarchar

nvarchar

nvarchar

주의

sp_OAMethod를 사용하여 속성 값을 구할 수도 있습니다.

사용 권한

sysadmin 고정 서버 역할의 멤버 자격이 필요합니다.

예

1.지역 변수 사용

다음 예에서는 이전에 생성된 SQLServer 개체의 HostName 속성을 가져온 후 지역 변수에 저장하는 방법을 보여 줍니다.

DECLARE @property varchar(255)
EXEC @hr = sp_OAGetProperty @object, 'HostName', @property OUT
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END
PRINT @property

2.결과 집합 사용

다음 예에서는 이전에 생성된 SQLServer 개체의 HostName 속성을 가져온 후 그 속성을 결과 집합으로 클라이언트에게 반환하는 방법을 보여 줍니다.

EXEC @hr = sp_OAGetProperty @object, 'HostName'
IF @hr <> 0
BEGIN
   EXEC sp_OAGetErrorInfo @object
    RETURN
END

참고 항목

참조

OLE 자동화 저장 프로시저(Transact-SQL)

OLE 자동화 예제 스크립트