GetNotificationResourceManagerAsync, fonction (ktmw32.h)

Article
08/24/2023

Demande et reçoit une notification asynchrone pour un gestionnaire de ressources (RM). Cette fonction est utilisée par le registre RM pour recevoir des notifications lorsqu’une transaction change d’état.

Syntaxe

BOOL GetNotificationResourceManagerAsync(
  [in]  HANDLE                    ResourceManagerHandle,
  [out] PTRANSACTION_NOTIFICATION TransactionNotification,
  [in]  ULONG                     TransactionNotificationLength,
  [out] PULONG                    ReturnLength,
  [in]  LPOVERLAPPED              lpOverlapped
);

Paramètres

[in] ResourceManagerHandle

Handle pour le gestionnaire de ressources.

[out] TransactionNotification

Pointeur vers une structure TRANSACTION_NOTIFICATION qui reçoit la première notification disponible.

[in] TransactionNotificationLength

Taille de la mémoire tampon TransactionNotification , en octets.

[out] ReturnLength

Pointeur vers une variable qui reçoit la taille réelle de la notification reçue par le paramètre TransactionNotification .

[in] lpOverlapped

Pointeur vers une structure CHEVAUCHEMENT requise pour l’opération asynchrone.

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 (0). Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.

La liste suivante identifie les codes d’erreur possibles :

Notes

Tous les gestionnaires de ressources doivent s’inscrire pour recevoir des notifications TRANSACTION_NOTIFY_PREPREPARE, TRANSACTION_NOTIFY_PREPARE et TRANSACTION_NOTIFY_COMMIT , même s’ils appellent par la suite ReadOnlyEnlistment pour marquer un enrôlement en lecture seule. Les gestionnaires de ressources peuvent prendre en charge TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT, mais ils doivent également prendre en charge les notifications de préparation, de préparation et de validation en plusieurs phases. Pour obtenir la liste de toutes les notifications que les gestionnaires de ressources peuvent recevoir, consultez TRANSACTION_NOTIFICATION.

Les gestionnaires de ressources (RM) peuvent appeler cette fonction plusieurs fois pour fournir plusieurs mémoires tampons à utiliser par KTM lors de la remise des notifications. Le nombre d’appels à cette fonction dépend de la charge que votre RM transporte.

Cette fonction doit être appelée après l’appel de la fonction SetResourceManagerCompletionPort .

Spécifications


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