RtmGetChangeStatus 関数 (rtmv2.h)

[アーティクル]
03/01/2024

RtmGetChangeStatus 関数は、RtmGetChangedDests で取得されていない保留中の変更があるかどうかを確認します。

構文

DWORD RtmGetChangeStatus(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_NOTIFY_HANDLE NotifyHandle,
  [in]  RTM_DEST_HANDLE   DestHandle,
  [out] PBOOL             ChangeStatus
);

パラメーター

[in] RtmRegHandle

RtmRegisterEntity の以前の呼び出しから取得したクライアントへのハンドル。

[in] NotifyHandle

変更通知を処理します。

[in] DestHandle

変更の状態を返す宛先を処理します。

[out] ChangeStatus

入力時、 ChangeStatus は BOOL 値へのポインターです。

出力時に、 ChangeStatus は TRUE または FALSE を 受け取り、 DestHandle で指定された宛先に変更通知が保留中かどうかを示します。

戻り値

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。

値	意味
ERROR_INVALID_HANDLE	ハンドルが正しくありません。

注釈

この関数を使用すると、クライアントコードの一部をより効率的にすることができます。たとえば、クライアントがまだ処理していない変更がある場合、クライアントは一部の操作を延期することがあります。

この関数は、別のスレッドで変更通知を監視するためにも使用できます。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	rtmv2.h
Library	Rtm.lib
[DLL]	Rtm.dll