sp_OASetProperty(Transact-SQL)
OLE 개체의 속성을 새 값으로 설정합니다.
적용 대상: SQL Server(SQL Server 2008부터 현재 버전까지). |
.gif "항목 링크 아이콘")
구문
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'