GetNotificationResourceManagerAsync 函式 (ktmw32.h)

發行項
03/14/2023

要求並接收資源管理員的非同步通知， (RM) 。 RM 暫存器會使用此函式在交易變更狀態時接收通知。

語法

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

參數

[in] ResourceManagerHandle

資源管理員的控制碼。

[out] TransactionNotification

接收第一個可用通知之 TRANSACTION_NOTIFICATION 結構的指標。

[in] TransactionNotificationLength

TransactionNotification緩衝區的大小，以位元組為單位。

[out] ReturnLength

變數的指標，可接收 TransactionNotification 參數所接收之通知的實際大小。

[in] lpOverlapped

非同步作業所需的重迭結構指標。

傳回值

如果函式成功，則傳回非零的值。

如果函式失敗，傳回值會是零 (0) 。若要取得擴充的錯誤資訊，請呼叫 GetLastError 函式。

下列清單會識別可能的錯誤碼：

備註

所有資源管理員都必須註冊才能接收 TRANSACTION_NOTIFY_PREPREPARE、 TRANSACTION_NOTIFY_PREPARE和 TRANSACTION_NOTIFY_COMMIT 通知，即使後續呼叫 ReadOnlyEnlistment 將登記標示為唯讀。資源管理員可以支援 TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT，但也必須支援多階段預先準備、準備和認可通知。如需資源管理員可接收的所有通知清單，請參閱 TRANSACTION_NOTIFICATION。

資源管理員 (RM) 可能會想要多次呼叫此函式，以提供多個緩衝區供 KTM 在傳遞通知時使用。此函式的呼叫數目取決於 RM 所攜帶的負載量。

呼叫 SetResourceManagerCompletionPort 函式之後，必須呼叫此函式。

需求


最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	ktmw32.h
程式庫	KtmW32.lib
Dll	KtmW32.dll