Función EnableRouter (iphlpapi.h)

La función EnableRouter activa el reenvío de IPv4 en el equipo local. EnableRouter también incrementa un recuento de referencias que realiza un seguimiento del número de solicitudes para habilitar el reenvío de IPv4.

Sintaxis

IPHLPAPI_DLL_LINKAGE DWORD EnableRouter(
  HANDLE     *pHandle,
  OVERLAPPED *pOverlapped
);

Parámetros

pHandle

Puntero a un identificador. Este parámetro no se usa actualmente.

pOverlapped

Puntero a una estructura OVERLAPPED. Excepto para el miembro hEvent , todos los miembros de esta estructura deben establecerse en cero. El miembro hEvent debe contener un identificador para un objeto de evento válido. Use la función CreateEvent para crear este objeto de evento.

Valor devuelto

Si la función EnableRouter se realiza correctamente, se ERROR_IO_PENDING el valor devuelto.

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

Código devuelto Descripción
ERROR_INVALID_PARAMETER
Uno de los parámetros no es válido. Este error se devuelve si el parámetro pOverlapped es NULL.
Otros
Use FormatMessage para obtener la cadena de mensaje del error devuelto.

Comentarios

La función EnableRouter es específica del reenvío de IPv4. Si el proceso que llama a EnableRouter finaliza sin llamar a UnableRouter, el sistema disminuye el recuento de referencias que realiza un seguimiento del número de solicitudes para habilitar el reenvío de IPv4 como si el proceso hubiera llamado UnableRouter.

Requisitos

   
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

CreateEvent

Referencia de la función auxiliar de IP

Página de inicio del asistente de IP

OVERLAPPED

UnableRouter