sp_OADestroy (Transact-SQL)

Si applica a: sìSQL Server (tutte le versioni supportate)

Elimina un oggetto OLE creato.

Icona di collegamento a un argomento Convenzioni della 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 (esito negativo) corrispondente al valore intero del codice HRESULT restituito dall'oggetto di automazione OLE.

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

Commenti

Se sp_OADestroy 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 execute direttamente in questa stored procedure. Ole Automation Procedures Per utilizzare qualsiasi procedura di sistema correlata all'automazione OLE, è necessario che la configurazione di sia abilitata.

Esempio

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

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

Vedere anche

Stored procedure di automazione OLE (Transact-SQL)
Script di automazione OLE di esempio