sp_OASetProperty (Transact-SQL)

適用於：SQL Server

將 OLE 物件的屬性設定為新的值。

語法

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

objecttoken
這是先前由sp_OACreate所建立之 OLE 對象的物件標記。

propertyname
這是要設定為新值之 OLE 物件的屬性名稱。

newvalue
這是屬性的新值，而且必須是適當數據類型的值。

index
這是索引參數。如果指定，索引必須是適當數據類型的值。

某些屬性具有參數。這些屬性稱為索引屬性，而且參數稱為索引參數。屬性可以有多個索引參數。

注意

這個預存程式的參數是由位置指定，而不是名稱。

0 （success）或非零數位（failure），這是 OLE Automation 物件所傳回之 HRESULT 的整數值。

如需 HRESULT 傳回碼的詳細資訊，請參閱 OLE Automation 傳回碼和錯誤資訊。

需要系統管理員固定伺服器角色的成員資格，或直接在此預存程式上執行許可權。 Ole Automation Procedures 必須啟用組態，才能使用任何與 OLE Automation 相關的系統程式。

下列範例會將 HostName 屬性（先前建立 的 SQLServer 物件）設定為新的值。

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