Función GetBestInterfaceEx (iphlpapi.h)

  • Artículo

La función GetBestInterfaceEx recupera el índice de la interfaz que tiene la mejor ruta a la dirección IPv4 o IPv6 especificada.

Sintaxis

IPHLPAPI_DLL_LINKAGE DWORD GetBestInterfaceEx(
  [in]  sockaddr *pDestAddr,
  [out] PDWORD   pdwBestIfIndex
);

Parámetros

[in] pDestAddr

Dirección IPv6 o IPv4 de destino para la que se va a recuperar la interfaz con la mejor ruta, en forma de una estructura de sockaddr .

[out] pdwBestIfIndex

Puntero al índice de la interfaz con la mejor ruta a la dirección IPv6 o IPv4 especificada por pDestAddr.

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.

Código devuelto Descripción
ERROR_CAN_NOT_COMPLETE
 No se pudo completar la operación.
ERROR_INVALID_PARAMETER
 Se pasó un parámetro no válido a la función. Este error se devuelve si se pasa un puntero NULL en el parámetro pdwBestIfIndex o si los parámetros pDestAddr o pdwBestIfIndex apuntan a la memoria a la que no se puede tener acceso. Este error también se puede devolver si el parámetro pdwBestIfIndex apunta a la memoria en la que no se puede escribir.
ERROR_NOT_SUPPORTED
 No se admite la solicitud. Este error se devuelve si no hay ninguna pila IPv4 en el equipo local y se especificó una dirección IPv4 en el parámetro pDestAddr o no hay ninguna pila IPv6 en el equipo local y se especificó una dirección IPv6 en el parámetro pDestAddr .
Otros
 Use la función FormatMessage para obtener la cadena de mensaje para el error devuelto.

Comentarios

La función GetBestInterfaceEx difiere de la función GetBestInterface en que se puede usar con direcciones IPv4 o IPv6.

El miembro Family de la estructura sockaddr a la que apunta el parámetro pDestAddr debe establecerse en uno de los siguientes valores: AF_INET o AF_INET6.

En Windows Vista y versiones posteriores, el asistente de IP trata internamente el parámetro pdwBestIfIndex como puntero a un tipo de datos NET_IFINDEX .

Requisitos

   
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado iphlpapi.h
Library Iphlpapi.lib
Archivo DLL Iphlpapi.dll

Consulte también

GetBestInterface

Referencia de la función auxiliar de IP

Página de inicio del asistente de IP

MIB_BEST_IF

sockaddr