Partager via


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

Indique si l’objet actuel s’exécute dans une transaction.

Syntaxe

HRESULT IsInTransaction(
  [out] VARIANT_BOOL *pbIsInTx
);

Paramètres

[out] pbIsInTx

TRUE si l’objet actuel s’exécute dans une transaction ; FALSE dans le cas contraire.

Valeur retournée

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 transmet son pointeur ObjectContext à un autre objet et si l’autre objet appelle IsInTransaction à 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

Vous pouvez utiliser cette méthode pour vous assurer qu’un objet qui nécessite une transaction ne s’exécute jamais sans celle-ci. Par exemple, si un composant qui nécessite une transaction n’est pas configuré de manière incorrecte dans l’outil d’administration Services de composants, vous pouvez utiliser cette méthode pour déterminer que l’objet n’a pas de transaction. Vous pouvez ensuite retourner une erreur pour avertir l’utilisateur du problème ou prendre les mesures approprié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