Funzione GetBestInterface (iphlpapi.h)

La funzione GetBestInterface recupera l'indice dell'interfaccia con la route migliore per l'indirizzo IPv4 specificato.

Syntax

IPHLPAPI_DLL_LINKAGE DWORD GetBestInterface(
  [in]  IPAddr dwDestAddr,
  [out] PDWORD pdwBestIfIndex
);

Parametri

[in] dwDestAddr

Indirizzo IPv4 di destinazione per il quale recuperare l'interfaccia con la route migliore, sotto forma di struttura IPAddr .

[out] pdwBestIfIndex

Puntatore a una variabile DWORD che riceve l'indice dell'interfaccia con la route migliore per l'indirizzo IPv4 specificato da dwDestAddr.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Codice restituito	Description
ERROR_CAN_NOT_COMPLETE	Impossibile completare l'operazione.
ERROR_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se un puntatore NULL viene passato nel parametro pdwBestIfIndex o se pdwBestIfIndex punta alla memoria che non può essere scritto.
ERROR_NOT_SUPPORTED	La richiesta non è supportata. Questo errore viene restituito se non è presente alcun stack IPv4 nel computer locale.
Altro	Utilizzare la funzione FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Osservazioni:

La funzione GetBestInterface funziona solo con gli indirizzi IPv4. Per l'uso con indirizzi IPv6, è necessario usare GetBestInterfaceEx .

Per informazioni sul tipo di dati IPAddr, vedere Windows tipi di dati. Per convertire un indirizzo IP tra la notazione decimale punteggiata e il formato IPAddr , usare le funzioni inet_addr e inet_ntoa .

In Windows Vista e versioni successive, il parametro pdwBestIfIndex viene considerato internamente dall'helper IP come puntatore a un tipo di dati NET_IFINDEX.

Requisiti

Requisito	Value
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Header	iphlpapi.h
Biblioteca	Iphlpapi.lib
DLL	Iphlpapi.dll

Vedere anche

GetBestInterfaceEx

GetBestRoute

Informazioni di riferimento sulle funzioni helper IP

Pagina iniziale dell'helper IP

IPAddr

MIB_BEST_IF

Tipi di dati di Windows