GetNotificationResourceManager 函式 (ktmw32.h)

發行項
02/28/2024

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

語法

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

參數

[in] ResourceManagerHandle

資源管理員的句柄。

[out] TransactionNotification

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

[in] NotificationLength

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

[in, optional] dwMilliseconds

在等候通知可供使用時，呼叫應用程式封鎖的時間，以毫秒為單位。如果逾時到期時沒有可用的通知，則會傳回 ERROR_TIMEOUT 。

[out, optional] ReturnLength

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

傳回值

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

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

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

備註

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

規格需求

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