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
Referencia de la función auxiliar de IP