Partager via


ObjectContext ::SetComplete, méthode (comsvcs.h)

Déclare que la transaction dans laquelle l’objet s’exécute peut être validée et que l’objet doit être désactivé au retour.

Syntaxe

HRESULT SetComplete();

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
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 ObjectContext à un autre objet et si l’autre objet appelle SetComplete à 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 désactivé automatiquement lors du retour de la méthode dans laquelle il a appelé SetComplete. Si l’objet est la racine d’une transaction automatique, COM+ tente de valider la transaction. Toutefois, si un objet participant à la transaction a appelé SetAbort, ou a appelé DisableCommit et n’a pas appelé par la suite EnableCommit ou SetComplete, la transaction est abandonnée.

Si un objet n’a pas besoin de conserver son état après son retour à partir d’un appel de méthode, il doit appeler SetComplete afin qu’il puisse être désactivé automatiquement dès qu’il retourne et que ses ressources peuvent être récupérées.

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

Objectcontext