sp_OADestroy (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Elimina un oggetto OLE creato.

Convenzioni di sintassi Transact-SQL

Sintassi

  
sp_OADestroy objecttoken

Argomenti

objecttoken
Token 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 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. Ole Automation Procedures la configurazione deve essere abilitata per utilizzare qualsiasi procedura di sistema correlata all'automazione OLE.

Esempi

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

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

Vedi anche

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