sp_OADestroy (Transact-SQL)

Artikel
12/22/2023

Zerstört ein zuvor erstelltes OLE-Objekt.

Syntax

  
sp_OADestroy objecttoken

Argumente

objecttoken
Das Objekttoken eines zuvor mit sp_OACreateerstellten OLE-Objekts.

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 OLE Automation Return Codes and Error Information.

Hinweise

Wird sp_OADestroy nicht aufgerufen, wird das erstellte OLE-Objekt am Ende des Batches automatisch gelöscht.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle "sysadmin " oder führt die Berechtigung direkt für diese gespeicherte Prozedur aus. Ole Automation ProceduresDie Konfiguration muss aktiviert sein, um alle Systemprozeduren im Zusammenhang mit der OLE-Automatisierung zu verwenden.

Beispiele

Im folgenden Beispiel wird das zuvor erstellte SQLServer -Objekt zerstört.

EXEC @hr = sp_OADestroy @object;  
IF @hr <> 0  
BEGIN  
   EXEC sp_OAGetErrorInfo @object  
    RETURN  
END;

Weitere Informationen

Gespeicherte OLE-Automatisierungsprozeduren (Transact-SQL)
OLE-Automatisierungsbeispielskript

Share via