Freigeben über


sp_OASetProperty (Transact-SQL)

Legt für eine Eigenschaft eines OLE-Objekts einen neuen Wert fest.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • objecttoken
    Das Objekttoken eines zuvor mit sp_OACreate erstellten OLE-Objekts

  • propertyname
    Der Eigenschaftsname des OLE-Objekts, dessen Wert neu festgelegt wird

  • newvalue
    Der neue Wert der Eigenschaft, der den entsprechenden Datentyp aufweisen muss

  • index
    Ein Indexparameter. Falls angegeben, muss index eine Variable vom entsprechenden Datentyp sein.

    Einige Eigenschaften besitzen Parameter. Diese Eigenschaften werden als indizierte Eigenschaften und die Parameter als Indexparameter bezeichnet. Eine Eigenschaft kann mehrere Indexparameter aufweisen.

    HinweisHinweis

    Die Parameter für diese gespeicherte Prozedur werden nicht nach dem Namen, sondern nach der Position angegeben.

Rückgabecodewerte

0 (Erfolg) oder eine Zahl ungleich Null (Fehler), die dem ganzzahligen Wert von HRESULT entspricht, der vom OLE-Automatisierungsobjekt zurückgegeben wird.

Weitere Informationen zu HRESULT-Rückgabecodes finden Sie unter Rückgabecodes und Fehlerinformationen der OLE-Automatisierung.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin.

Beispiele

Im folgenden Beispiel wird für die HostName-Eigenschaft (eines zuvor erstellten SQLServer-Objekts) ein neuer Wert festgelegt.

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