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.
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 |
|---|---|
|
No se pudo completar la operación. |
|
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. |
|
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 . |
|
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
Referencia de la función auxiliar de IP