Funzione GetBestInterface (iphlpapi.h)

Articolo
03/05/2024

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

Sintassi

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 viene NO_ERROR.

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

Codice restituito	Descrizione
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 nel computer locale non è presente alcun stack IPv4.
Altri	Utilizzare la funzione FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

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

Per informazioni sul tipo di dati IPAddr , vedere Tipi di dati Windows. Per convertire un indirizzo IP tra notazione decimale punteggiata e 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	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	iphlpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll