IObjectContext ::SetAbort, méthode (comsvcs.h)

  • Article

Déclare que la transaction dans laquelle l’objet s’exécute doit être abandonnée et que l’objet doit être désactivé lorsqu’il retourne à partir de l’appel de méthode en cours d’exécution.

Syntaxe

HRESULT SetAbort();

Valeur de retour

Cette méthode peut retourner les valeurs suivantes.

Code de retour Description
S_OK
 La commande s'est correctement terminée.
E_UNEXPECTED
 Une erreur inattendue s’est produite. Cela peut se produire si un objet passe son pointeur IObjectContext à un autre objet et que l’autre objet appelle SetAbort à l’aide de ce pointeur. Un pointeur IObjectContext n’est pas valide en dehors du contexte de l’objet qui l’a obtenu à l’origine.

Remarques

L’objet est automatiquement désactivé lors du retour de la méthode dans laquelle il a appelé SetAbort. Si l’objet est la racine d’une transaction automatique, COM+ abandonne la transaction. Si l’objet est transactionnel mais pas la racine d’une transaction automatique, la transaction à laquelle il participe est vouée à l’abandon.

Vous pouvez appeler SetAbort dans les gestionnaires d’erreurs pour vous assurer qu’une transaction abandonne lorsqu’une erreur se produit. Vous pouvez également appeler SetAbort au début d’une méthode pour empêcher votre objet de valider prématurément en cas de retour inattendu, puis, si tout se passe bien, appeler SetComplete juste avant le retour de la méthode.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête comsvcs.h

Voir aussi

IObjectContext