ObjectContext ::SetAbort, méthode (comsvcs.h)
Déclare que la transaction dans laquelle l’objet s’exécute doit être abandonnée et que l’objet doit être désactivé au retour.
Syntaxe
HRESULT SetAbort();
Valeur de retour
Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY et E_FAIL, ainsi que les valeurs suivantes.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée. |
|
Une erreur inattendue s’est produite. Cela peut se produire si un objet passe son pointeur ObjectContext à un autre objet et que l’autre objet appelle SetAbort à l’aide de ce pointeur. Un pointeur ObjectContext 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 |