Condividi tramite


sp_OADestroy (Transact-SQL)

Si applica a: SQL Server

Elimina un oggetto OLE creato.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_OADestroy objecttoken
[ ; ]

Argomenti

objecttoken

Token dell'oggetto di un oggetto OLE creato in precedenza tramite sp_OACreate.

Valori del codice restituito

0 (esito positivo) o un numero diverso da zero (errore) che corrisponde al valore intero dell'oggetto HRESULT restituito dall'oggetto automazione OLE.

Per altre informazioni sui codici restituiti HRESULT, vedere Codici restituiti di automazione OLE e informazioni sugli errori.

Osservazioni:

Se sp_OADestroy non viene chiamato, l'oggetto OLE creato viene eliminato automaticamente alla fine del batch.

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server sysadmin o l'autorizzazione di esecuzione direttamente in questa stored procedure. L'opzione di configurazione del server Ole Automation Procedures deve essere abilitata per utilizzare qualsiasi procedura di sistema correlata all'automazione OLE.

Esempi

Nell'esempio seguente viene eliminato definitivamente l'oggetto creato SQLServer in precedenza.

EXEC @hr = sp_OADestroy @object;

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

    RETURN
END;