sp_OASetProperty (Transact-SQL)

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 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.

  Hinweis
  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

Siehe auch

Verweis

Gespeicherte OLE-Automatisierungsprozeduren (Transact-SQL)

OLE-Automatisierungsbeispielskript