IObjectContext ::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é lorsqu’il retourne à partir de l’appel de méthode en cours d’exécution.

Syntaxe

HRESULT SetComplete();

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 si l’autre objet appelle SetComplete à 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é SetComplete. Si l’objet est la racine d’une transaction automatique, COM+ tente de valider la transaction. Toutefois, si un objet qui a participé à la transaction a appelé SetAbort, ou a appelé DisableCommit et n’a pas par la suite appelé 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 automatiquement désactivé dès qu’il est retourné et que ses ressources puissent ê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

IObjectContext