Função RtmGetChangeStatus (rtmv2.h)

A função RtmGetChangeStatus verifica se há alterações pendentes que não foram recuperadas com RtmGetChangedDests.

Sintaxe

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

Parâmetros

[in] RtmRegHandle

Identificador para o cliente obtido de uma chamada anterior para RtmRegisterEntity.

[in] NotifyHandle

Manipule para uma notificação de alteração.

[in] DestHandle

Manipule para o destino para o qual retornar a alteração status.

[out] ChangeStatus

Na entrada, ChangeStatus é um ponteiro para um valor BOOL .

Na saída, ChangeStatus recebe TRUE ou FALSE para indicar se o destino especificado por DestHandle tem uma notificação de alteração pendente.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado será um dos códigos de erro a seguir.

Comentários

Essa função pode ser usada para tornar partes do código do cliente mais eficientes. Por exemplo, um cliente poderá adiar alguma operação se houver alterações que o cliente ainda não tenha processado.

Essa função também pode ser usada para monitorar a notificação de alteração em outro thread.

Requisitos

Confira também

RTM_EVENT_CALLBACK

RtmGetChangedDests

RtmIgnoreChangedDests

RtmIsMarkedForChangeNotification

RtmMarkDestForChangeNotification

RtmReleaseChangedDests