Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
La función GetBestInterface recupera el índice de la interfaz que tiene la mejor ruta a la dirección IPv4 especificada.
Syntax
IPHLPAPI_DLL_LINKAGE DWORD GetBestInterface(
[in] IPAddr dwDestAddr,
[out] PDWORD pdwBestIfIndex
);
Parámetros
[in] dwDestAddr
Dirección IPv4 de destino para la que se va a recuperar la interfaz que tiene la mejor ruta, en forma de una estructura IPAddr .
[out] pdwBestIfIndex
Puntero a una variable DWORD que recibe el índice de la interfaz que tiene la mejor ruta a la dirección IPv4 especificada por dwDestAddr.
Valor de retorno
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 |
|---|---|
|
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 pdwBestIfIndex apunta a la memoria que no se puede escribir. |
|
No se admite la solicitud. Este error se devuelve si no hay ninguna pila IPv4 en el equipo local. |
|
Use la función FormatMessage para obtener la cadena de mensaje para el error devuelto. |
Observaciones
La función GetBestInterface solo funciona con direcciones IPv4. Para su uso con direcciones IPv6, se debe usar GetBestInterfaceEx .
Para obtener información sobre el tipo de datos IPAddr, consulte Windows tipos de datos. Para convertir una dirección IP entre la notación decimal con puntos y el formato IPAddr , use las funciones inet_addr y inet_ntoa .
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 | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| Header | iphlpapi.h |
| Library | Iphlpapi.lib |
| DLL de |
Iphlpapi.dll |
Consulte también
Referencia de la función auxiliar de IP