GetTransactionInformation, fonction (ktmw32.h)
Retourne les informations demandées sur la transaction spécifiée.
Syntaxe
BOOL GetTransactionInformation(
[in] HANDLE TransactionHandle,
[out, optional] PDWORD Outcome,
[out, optional] PDWORD IsolationLevel,
[out, optional] PDWORD IsolationFlags,
[out, optional] PDWORD Timeout,
[in] DWORD BufferLength,
[out, optional] LPWSTR Description
);
Paramètres
[in] TransactionHandle
Handle de la transaction. Le handle doit disposer de l’autorisation TRANSACTION_QUERY_INFORMATION pour récupérer les informations.
[out, optional] Outcome
Pointeur vers une mémoire tampon qui reçoit le résultat actuel de la transaction. Si l’appel à la fonction GetTransactionInformation réussit, cette valeur sera l’une des valeurs d’énumération TRANSACTION_OUTCOME .
[out, optional] IsolationLevel
Réservé.
[out, optional] IsolationFlags
Réservé.
[out, optional] Timeout
Pointeur vers une variable qui reçoit la valeur de délai d’expiration, en millisecondes, pour cette transaction.
[in] BufferLength
Taille du paramètre Description , en octets. La valeur de longueur de mémoire tampon ne peut pas être supérieure à la valeur de MAX_TRANSACTION_DESCRIPTION_LENGTH.
[out, optional] Description
Pointeur vers une mémoire tampon qui reçoit la description définie par l’utilisateur de la transaction.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.
La liste suivante identifie les codes d’erreur possibles :
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | ktmw32.h |
| Bibliothèque | Ktmw32.lib |
| DLL | Ktmw32.dll |