sp_OASetProperty (Transact-SQL)
Gilt für: 
SQL Server
Legt für eine Eigenschaft eines OLE-Objekts einen neuen Wert fest.
Transact-SQL-Syntaxkonventionen
Syntax
sp_OASetProperty objecttoken
, propertyname
, newvalue
[ , index... ]
[ ; ]
Argumente
objecttoken
Das Objekttoken eines OLE-Objekts, das zuvor von sp_OACreate.
propertyname
Der Eigenschaftenname des OLE-Objekts, das auf einen neuen Wert festgelegt werden soll.
neuer Wert
Der neue Wert der Eigenschaft und muss ein Wert des entsprechenden Datentyps sein.
Index
Ein Indexparameter. Wenn angegeben, muss index ein Wert des entsprechenden Datentyps sein.
Einige Eigenschaften besitzen Parameter. Diese Eigenschaften werden als Indiziert-Eigenschaften und die Parameter als Indexparameter bezeichnet. Eine Eigenschaft kann mehrere Indexparameter aufweisen.
Hinweis
Die Parameter für diese gespeicherte Prozedur werden durch Position und nicht durch den Namen angegeben.
Rückgabecodewerte
0 (Erfolg) oder eine Nichtzeronummer (Fehler), die den ganzzahligen Wert des vom OLE-Automatisierungsobjekt zurückgegebenen HRESULT-Werts darstellt.
Weitere Informationen zu HRESULT-Rückgabecodes finden Sie unter OLE-Automatisierungsrücklaufcodes und Fehlerinformationen.
Berechtigungen
Erfordert die Mitgliedschaft in der festen Serverrolle "sysadmin ", oder führen Sie die Berechtigung direkt für diese gespeicherte Prozedur aus. Die Serverkonfigurationsoption "Ole Automation Procedures " muss aktiviert sein, um alle Systemprozeduren im Zusammenhang mit der OLE-Automatisierung zu verwenden.
Beispiele
Im folgenden Beispiel wird die HostName Eigenschaft (des zuvor erstellten SQLServer Objekts) auf einen neuen Wert festgelegt.
EXEC @hr = sp_OASetProperty @object,
'HostName',
'Gizmo';
IF @hr <> 0
BEGIN
EXEC sp_OAGetErrorInfo @object
RETURN
END;