GetNotificationResourceManager, fonction (ktmw32.h)

Article
02/28/2024

Demande et reçoit une notification 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 GetNotificationResourceManager(
  [in]            HANDLE                    ResourceManagerHandle,
  [out]           PTRANSACTION_NOTIFICATION TransactionNotification,
  [in]            ULONG                     NotificationLength,
  [in, optional]  DWORD                     dwMilliseconds,
  [out, optional] PULONG                    ReturnLength
);

Paramètres

[in] ResourceManagerHandle

Handle du gestionnaire de ressources.

[out] TransactionNotification

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

[in] NotificationLength

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

[in, optional] dwMilliseconds

Durée, en millisecondes, pendant laquelle l’application appelante se bloque en attendant que la notification soit disponible. Si aucune notification n’est disponible à l’expiration du délai d’expiration, ERROR_TIMEOUT est retourné.

[out, optional] ReturnLength

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

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 :

Remarques

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 une inscription 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é-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.

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