rtmGetChangedDests 函式 (rtmv2.h)
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。
如果函式失敗，傳回值就是下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
參數包含不正確的資訊。 |
|
不再變更要擷取的目的地。 |
備註
用戶端會收到 RTM_EVENT_CALLBACK變更的通知。 RTM_EVENT_CALLBACK只會用來通知用戶端，而不是傳遞變更。 收到變更通知之後，客戶端必須重複呼叫 RtmGetChangedDests 以擷取所有變更。
如果在通知之後發生相同目的地的兩個或多個變更，則只會傳回最新的變更。
當用戶端不再需要 ChangedDests 中的句柄時，客戶端必須使用 RtmReleaseChangedDests 釋放句柄。
如需使用此函式的範例程式代碼，請參閱 使用事件通知回呼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | rtmv2.h |
| 程式庫 | Rtm.lib |
| Dll | Rtm.dll |
另請參閱
RtmIsMarkedForChangeNotification