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

참고 항목

참조

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

OLE 자동화 예제 스크립트