Función GetBestInterfaceEx (iphlpapi.h)

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

Syntax

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 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 de retorno	Description
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.

Observaciones

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 parámetro pdwBestIfIndex lo trata internamente el asistente de IP como puntero a un tipo de datos NET_IFINDEX.

Requisitos

Requirement	Importancia
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido	Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
Header	iphlpapi.h
Library	Iphlpapi.lib
DLL de	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