sp_OASetProperty(Transact-SQL)

적용 대상:SQL Server

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

구문

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

objecttoken
sp_OACreate 이전에 만든 OLE 개체의 개체 토큰입니다.

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

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

인덱스
인덱스 매개 변수입니다. 지정한 경우 인덱 스가 적절한 데이터 형식의 값이어야 합니다.

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

참고 항목

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

OLE Automation 개체에서 반환된 HRESULT의 정수 값인 0(성공) 또는 0이 아닌 숫자(실패)입니다.

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

sysadmin 고정 서버 역할의 멤버 자격이 필요하거나 이 저장 프로시저에 대한 직접 실행 권한이 필요합니다. Ole Automation ProceduresOLE 자동화와 관련된 시스템 프로시저를 사용하려면 구성을 사용하도록 설정해야 합니다.

다음은 이전에 만든 SQLServer 개체의 속성을 새 값으로 설정하는 HostName 예제입니다.

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