Partager via


sp_OADestroy (Transact-SQL)

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 sp_OACreatede .

Valeurs des codes de retour

0 (réussite) ou nombre différent de zéro (échec) qui est la valeur entière du HRESULT retourné par l’objet OLE Automation.

Pour plus d’informations sur les codes de retour HRESULT, consultez les codes de retour OLE Automation et les informations d’erreur.

Notes

Si sp_OADestroy ce n’est pas le cas, 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. L’option de configuration du serveur Procédures Ole Automation 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 créé SQLServer précédemment.

EXEC @hr = sp_OADestroy @object;

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

    RETURN
END;