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 |
|---|---|
|
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 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 |