sp_OADestroy (Transact-SQL)

S’applique à :SQL Server (toutes les versions prises en charge)

Détruit un objet OLE créé.

Conventions de la syntaxe Transact-SQL

Syntaxe

  
sp_OADestroy objecttoken      

Arguments

objecttoken
Jeton d’objet d’un objet OLE créé précédemment à l’aide de sp_OACreate.

Codet de retour

0 (succès) ou un nombre différent de zéro (échec), qui représente la valeur entière de HRESULT renvoyée par l'objet OLE Automation.

Pour plus d’informations sur les codes de retour HRESULT, consultez OLE Automation Return Codes and Error Information.

Remarques

Si sp_OADestroy n’est pas appelée, l’objet OLE créé est automatiquement détruit à la fin du lot.

Autorisations

Nécessite l’appartenance au rôle serveur fixe sysadmin ou l’autorisation d’exécution directement sur cette procédure stockée. Ole Automation Procedures la configuration doit être activée pour utiliser toute procédure système liée à OLE Automation.

Exemples

L’exemple suivant détruit l’objet SQLServer précédemment créé.

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

Voir aussi

Procédures stockées OLE Automation (Transact-SQL)
Exemple de script OLE Automation