Función RtmMarkDestForChangeNotification (rtmv2.h)

La función RtmMarkDestForChangeNotification marca un destino para un cliente. Un destino marcado indica al administrador de tablas de enrutamiento que debe enviar los mensajes de notificación de cambio de cliente para el destino marcado. El cliente recibe mensajes de notificación de cambios cuando cambia un destino. Las notificaciones de cambio informan al cliente de los cambios en la información de mejor ruta para el destino especificado. Esta función se debe usar cuando se llama a RtmRegisterForChangeNotification para solicitar cambios para destinos específicos (RTM_NOTIFY_ONLY_MARKED_DESTS).

Sintaxis

DWORD RtmMarkDestForChangeNotification(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] RTM_DEST_HANDLE   DestHandle,
  [in] BOOL              MarkDest
);

Parámetros

[in] RtmRegHandle

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

[in] NotifyHandle

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

[in] DestHandle

Controle al destino que el cliente marca para la notificación de cambios.

[in] MarkDest

Especifica si se marca un destino y se reciben notificaciones de cambio. Especifique TRUE para marcar un destino e iniciar recibir notificaciones de cambio para el destino especificado. Especifique FALSE para dejar de recibir notificaciones de cambio un destino marcado previamente.

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_HANDLE	El identificador no es válido.

 

 

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

RtmGetChangeStatus

RtmGetChangedDests

RtmIgnoreChangedDests

RtmIsMarkedForChangeNotification

RtmRegisterForChangeNotification

RtmReleaseChangedDests