rtmGetChangedDests 函式 (rtmv2.h)

發行項
03/01/2024

RtmGetChangedDests 函式會傳回一組含有變更資訊的目的地。

語法

DWORD RtmGetChangedDests(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      RTM_NOTIFY_HANDLE NotifyHandle,
  [in, out] PUINT             NumDests,
  [out]     PRTM_DEST_INFO    ChangedDests
);

參數

[in] RtmRegHandle

從先前呼叫 RtmRegisterEntity 取得的用戶端句柄。

[in] NotifyHandle

處理從先前呼叫 RtmRegisterForChangeNotification 取得的變更通知。

[in, out] NumDests

在輸入時， NumDests 是 UINT 值的指標，指定 ChangedDests 可接收的目的地數目上限。

輸出時， NumDests 會接收 ChangedDests 所接收的實際目的地數目。

[out] ChangedDests

在輸入上， ChangedDests 是 RTM_DEST_INFO 結構的陣列指標。

在輸出上， ChangedDests 會填入已變更的目的地資訊。

傳回值

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值	意義
ERROR_INVALID_PARAMETER	參數包含不正確的資訊。
ERROR_NO_MORE_ITEMS	不再變更要擷取的目的地。

備註

用戶端會收到 RTM_EVENT_CALLBACK變更的通知。 RTM_EVENT_CALLBACK只會用來通知用戶端，而不是傳遞變更。收到變更通知之後，客戶端必須重複呼叫 RtmGetChangedDests 以擷取所有變更。

如果在通知之後發生相同目的地的兩個或多個變更，則只會傳回最新的變更。

當用戶端不再需要 ChangedDests 中的句柄時，客戶端必須使用 RtmReleaseChangedDests 釋放句柄。

如需使用此函式的範例程式代碼，請參閱使用事件通知回呼。

規格需求

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