GetNotificationResourceManager 関数 (ktmw32.h)

[アーティクル]
03/09/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 以外になります。

関数が失敗した場合は、0 を返します。エラーの詳細情報を得るには、GetLastError 関数を呼び出します。

次の一覧は、考えられるエラーコードを示しています。

注釈

すべてのリソースマネージャーは、その後 ReadOnlyEnlistment を呼び出して参加リストを読み取り専用としてマークする場合でも、TRANSACTION_NOTIFY_PREPREPARE、TRANSACTION_NOTIFY_PREPARE、およびTRANSACTION_NOTIFY_COMMIT通知を受信するために登録する必要があります。リソースマネージャーは TRANSACTION_NOTIFY_SINGLE_PHASE_COMMITをサポートできますが、マルチフェーズの事前準備、準備、コミット通知もサポートする必要があります。リソースマネージャーが受信できるすべての通知の一覧については、「 TRANSACTION_NOTIFICATION」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	ktmw32.h
Library	KtmW32.lib
[DLL]	KtmW32.dll