Función RtmGetChangedDests (rtmv2.h)

Artículo
03/05/2024

La función RtmGetChangedDests devuelve un conjunto de destinos con información modificada.

Sintaxis

DWORD RtmGetChangedDests(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      RTM_NOTIFY_HANDLE NotifyHandle,
  [in, out] PUINT             NumDests,
  [out]     PRTM_DEST_INFO    ChangedDests
);

Parámetros

[in] RtmRegHandle

Identificador para el cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] NotifyHandle

Controle a una notificación de cambio obtenida de una llamada anterior a RtmRegisterForChangeNotification.

[in, out] NumDests

En la entrada, NumDests es un puntero a un valor UINT que especifica el número máximo de destinos que se pueden recibir mediante ChangedDests.

En la salida, NumDests recibe el número real de destinos recibidos por ChangedDests.

[out] ChangedDests

En la entrada, ChangedDests es un puntero a una matriz de estructuras de RTM_DEST_INFO .

En la salida, ChangedDests se rellena con la información de destino modificada.

Valor devuelto

Si la función se ejecuta 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_PARAMETER	Un parámetro contiene información incorrecta.
ERROR_NO_MORE_ITEMS	No se cambiaron más destinos para recuperar.

Comentarios

Un RTM_EVENT_CALLBACK notifica a un cliente los cambios. El RTM_EVENT_CALLBACK solo se usa para notificar al cliente, no entregar los cambios. Una vez recibida una notificación de cambio, el cliente debe llamar repetidamente a RtmGetChangedDests para recuperar todos los cambios.

Si se han producido dos o más cambios en el mismo destino desde la notificación, solo se devuelve el cambio más reciente.

Cuando un cliente ya no necesita los identificadores en ChangedDests, el cliente debe usar RtmReleaseChangedDests para liberar los identificadores.

Para obtener código de ejemplo con esta función, consulte Uso de la devolución de llamada de notificación de eventos.

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