共用方式為


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

在輸入時, NumDestsUINT 值的指標,指定 ChangedDests 可接收的目的地數目上限。

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

[out] ChangedDests

在輸入上, ChangedDestsRTM_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

另請參閱

RTM_DEST_INFO

RTM_EVENT_CALLBACK

RtmGetChangeStatus

RtmIgnoreChangedDests

RtmIsMarkedForChangeNotification

RtmMarkDestForChangeNotification

RtmReleaseChangedDests