RtmGetChangeStatus 函式 (rtmv2.h)

發行項
03/05/2024

RtmGetChangeStatus 函式會檢查是否有未使用 RtmGetChangedDests 擷取的暫止變更。

語法

DWORD RtmGetChangeStatus(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_NOTIFY_HANDLE NotifyHandle,
  [in]  RTM_DEST_HANDLE   DestHandle,
  [out] PBOOL             ChangeStatus
);

參數

[in] RtmRegHandle

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

[in] NotifyHandle

變更通知的句柄。

[in] DestHandle

處理要傳回變更狀態的目的地。

[out] ChangeStatus

在輸入時， ChangeStatus 是 BOOL 值的指標。

在輸出時， ChangeStatus 會收到 TRUE 或 FALSE ，以指出 DestHandle 指定的目的地是否有擱置的變更通知。

傳回值

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

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

值	意義
ERROR_INVALID_HANDLE	控制代碼無效。

備註

此函式可用來讓部分用戶端程序代碼更有效率。例如，如果用戶端尚未處理變更，用戶端可能會延後某些作業。

此函式也可以用來監視另一個線程中的變更通知。

規格需求

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