RtmReleaseChangedDests 関数 (rtmv2.h)

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

RtmReleaseChangedDests 関数は、変更された宛先ハンドルを解放します。

構文

DWORD RtmReleaseChangedDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] UINT              NumDests,
  [in] PRTM_DEST_INFO    ChangedDests
);

パラメーター

[in] RtmRegHandle

RtmRegisterEntity の以前の呼び出しから取得したクライアントを処理します。

[in] NotifyHandle

RtmRegisterForChangeNotification の以前の呼び出しから取得した変更通知を処理します。

[in] NumDests

ChangedDests の宛先の数を指定します。

[in] ChangedDests

解放する RTM_DEST_INFO 構造体の配列へのポインター。変更された宛先は、 RtmGetChangedDests の以前の呼び出しから取得されました。

戻り値

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

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

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

注釈

RtmGetChangedDests の呼び出しから取得した変更されたRTM_DEST_INFO構造体を解放するには、常にこの関数を使用します。

RTM_DEST_INFO構造体は、可変サイズの構造体です。変換先に複数のビューの情報が含まれている場合、ビューごとに RTM_DEST_INFO のサイズが大きくなります。この関数を呼び出す前に割り当てる ChangedDests バッファーの大きさを確認するには、RTM_SIZE_OF_DEST_INFO マクロを使用します。

要件

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