sp_OADestroy (Transact-SQL)

  • Article

S’applique à :SQL Server

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.

Notes

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 n’importe quelle procédure système liée à OLE Automation.

Exemples

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

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