RtmReleaseChangedDests 函式 (rtmv2.h)

發行項
03/05/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 的大小就會增加。使用 RTM_SIZE_OF_DEST_INFO 宏來判斷在呼叫此函式之前， 要配置之 ChangedDests 緩衝區的大小。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	rtmv2.h
程式庫	Rtm.lib
Dll	Rtm.dll