Função RtmGetChangeStatus (rtmv2.h)

Artigo
03/13/2024

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.

Valor	Significado
ERROR_INVALID_HANDLE	O manipulador é inválido.

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

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	rtmv2.h
Biblioteca	Rtm.lib
DLL	Rtm.dll