GetNotificationResourceManager 函式 (ktmw32.h)
要求並接收資源管理員 (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 |
另請參閱
GetNotificationResourceManagerAsync