Función UnableRouter (iphlpapi.h)

La función UnableRouter disminuye el recuento de referencias que realiza un seguimiento del número de solicitudes para habilitar el reenvío de IPv4. Cuando este recuento de referencias alcanza cero, UnableRouter desactiva el reenvío de IPv4 en el equipo local.

Sintaxis

IPHLPAPI_DLL_LINKAGE DWORD UnenableRouter(
                  OVERLAPPED *pOverlapped,
  [out, optional] LPDWORD    lpdwEnableCount
);

Parámetros

pOverlapped

Puntero a una estructura OVERLAPPED. Esta estructura debe ser la misma que la usada en la llamada a la función EnableRouter .

[out, optional] lpdwEnableCount

Puntero opcional a una variable DWORD . Esta variable recibe el número de referencias restantes.

Valor devuelto

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

Si se produce un error en la función, use FormatMessage para obtener la cadena de mensaje para el error devuelto.

Comentarios

La función UnableRouter es específica del reenvío de IPv4. Cada llamada que realiza un proceso a UnableRouter debe corresponder a una llamada anterior a EnableRouter por el mismo proceso. El sistema devuelve un error en llamadas extrañas a UnableRouter. Como resultado, un proceso determinado no puede disminuir el recuento de referencias que realiza un seguimiento del número de solicitudes para habilitar el reenvío de IPv4 para otro proceso. Además, si un proceso determinado ha habilitado el reenvío IPv4, no puede deshabilitarlo un proceso diferente.

No es posible determinar con precisión el recuento de referencias que realiza un seguimiento del número de solicitudes para habilitar el reenvío de IPv4, ya que puede haber otras solicitudes EnableRouter pendientes. Por lo tanto, el valor devuelto para el parámetro lpdwEnableCount siempre es un recuento grande igual a ULONG_MAX/2.

Si el proceso que llama a EnableRouter finaliza sin llamar a UnableRouter, el sistema disminuye el recuento de referencias que realiza un seguimiento de las solicitudes para habilitar el reenvío de IPv4 como si el proceso hubiera llamado UnableRouter.

Después de llamar a UnableRouter, use la llamada CloseHandle para cerrar el identificador del objeto de evento en la estructura SUPERPUESTA .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	iphlpapi.h
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll

Consulte también

CloseHandle

EnableRouter

Referencia de la función auxiliar de IP

Página de inicio del asistente de IP

OVERLAPPED