Funzione GetNotificationResourceManager (ktmw32.h)

Articolo
02/28/2024

Richieste e riceve una notifica per un resource manager (RM). Questa funzione viene usata dal registro RM per ricevere notifiche quando una transazione cambia stato.

Sintassi

BOOL GetNotificationResourceManager(
  [in]            HANDLE                    ResourceManagerHandle,
  [out]           PTRANSACTION_NOTIFICATION TransactionNotification,
  [in]            ULONG                     NotificationLength,
  [in, optional]  DWORD                     dwMilliseconds,
  [out, optional] PULONG                    ReturnLength
);

Parametri

[in] ResourceManagerHandle

Handle per resource manager.

[out] TransactionNotification

Puntatore a una struttura TRANSACTION_NOTIFICATION che riceve la prima notifica disponibile.

[in] NotificationLength

Dimensioni del buffer TransactionNotification , in byte.

[in, optional] dwMilliseconds

Tempo, in millisecondi, per il quale l'applicazione chiamante blocca durante l'attesa che la notifica diventi disponibile. Se non sono disponibili notifiche alla scadenza del timeout, ERROR_TIMEOUT viene restituito.

[out, optional] ReturnLength

Puntatore a una variabile che riceve le dimensioni effettive della notifica ricevuta dal parametro TransactionNotification .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero (0). Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

L'elenco seguente identifica i possibili codici di errore:

Commenti

Tutti i responsabili delle risorse devono registrarsi per ricevere TRANSACTION_NOTIFY_PREPREPARE, TRANSACTION_NOTIFY_PREPAREe TRANSACTION_NOTIFY_COMMIT notifiche, anche se successivamente chiamano ReadOnlyEnlistment per contrassegnare un inserimento come sola lettura. I responsabili delle risorse possono supportare TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT, ma devono anche supportare le notifiche di pre-preparazione, preparazione e commit in più fasi. Per l'elenco di tutte le notifiche che possono ricevere i responsabili delle risorse, vedere TRANSACTION_NOTIFICATION.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	ktmw32.h
Libreria	KtmW32.lib
DLL	KtmW32.dll