Función RtmGetChangeStatus (rtmv2.h)

La función RtmGetChangeStatus comprueba si hay cambios pendientes que no se han recuperado con RtmGetChangedDests.

Sintaxis

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 del cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] NotifyHandle

Identificador de una notificación de cambio.

[in] DestHandle

Identificador del destino para el que se va a devolver el estado de cambio.

[out] ChangeStatus

En la entrada, ChangeStatus es un puntero a un valor BOOL .

En la salida, ChangeStatus recibe TRUE o FALSE para indicar si el destino especificado por DestHandle tiene pendiente una notificación de cambio.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor Significado
ERROR_INVALID_HANDLE
 El identificador no es válido.
 
 

Comentarios

Esta función se puede usar para hacer que las partes del código de cliente sean más eficaces. Por ejemplo, un cliente puede posponer alguna operación si hay cambios que el cliente aún no ha procesado.

Esta función también se puede usar para supervisar la notificación de cambios en otro subproceso.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado rtmv2.h
Library Rtm.lib
Archivo DLL Rtm.dll

Consulte también

RTM_EVENT_CALLBACK

RtmGetChangedDests

RtmIgnoreChangedDests

RtmIsMarkedForChangeNotification

RtmMarkDestForChangeNotification

RtmReleaseChangedDests

  • Last updated on