Teilen über


sp_OADestroy (Transact-SQL)

Gilt für: SQL Server

Zerstört ein zuvor erstelltes OLE-Objekt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_OADestroy objecttoken
[ ; ]

Argumente

objecttoken

Das Objekttoken eines OLE-Objekts, das zuvor mithilfe sp_OACreatevon .

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.

Hinweise

Wenn sp_OADestroy nicht aufgerufen wird, wird das erstellte OLE-Objekt automatisch am Ende des Batches zerstört.

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 das zuvor erstellte Objekt zerstört SQLServer .

EXEC @hr = sp_OADestroy @object;

IF @hr <> 0
BEGIN
    EXEC sp_OAGetErrorInfo @object;

    RETURN
END;