다음을 통해 공유

  • 아티클

sp_OASetProperty(Transact-SQL)

OLE 개체의 속성을 새 값으로 설정합니다.

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

구문

sp_OASetProperty objecttoken , propertyname , newvalue [ , index... ]

인수

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

  • propertyname
    새 값으로 설정할 OLE 개체의 속성 이름입니다.

  • newvalue
    속성의 새 값이며 반드시 적절한 데이터 형식의 값이어야 합니다.

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

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

    [!참고]

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

반환 코드 값

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

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

사용 권한

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

예

다음 예에서는 이전에 생성된 SQLServer 개체의 HostName 속성을 새 값으로 설정합니다.

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