Функция RtmGetChangeStatus (rtmv2.h)

Статья
03/01/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
Header	rtmv2.h
Библиотека	Rtm.lib
DLL	Rtm.dll