Función RtmIgnoreChangedDests (rtmv2.h)

La función RtmIgnoreChangedDests omite el siguiente cambio para cada destino si ya se ha producido. Esta función se puede usar después de RtmGetChangeStatus para evitar que el administrador de tablas de enrutamiento devuelva este cambio en respuesta a una llamada a RtmGetChangedDests.

Sintaxis

DWORD RtmIgnoreChangedDests(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] RTM_NOTIFY_HANDLE NotifyHandle,
  [in] UINT              NumDests,
  [in] PRTM_DEST_HANDLE  ChangedDests
);

Parámetros

[in] RtmRegHandle

Identificador del cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] NotifyHandle

Identificador de una notificación de cambio.

[in] NumDests

Especifica el número de destinos en ChangedDests.

[in] ChangedDests

Puntero a una matriz de RTM_DEST_HANDLE identificadores que indican los destinos para los que se omitirán los cambios pendientes.

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

Cuando los destinos ya no sean necesarios, ábralos llamando a RtmReleaseChangedDests.

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

RtmIsMarkedForChangeNotification

RtmMarkDestForChangeNotification

RtmReleaseChangedDests