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 |
|---|---|
|
La commande s'est correctement terminée. |
|
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 |