Condividi tramite


Funzione GetBestInterface (iphlpapi.h)

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

Vedi anche

GetBestInterfaceEx

GetBestRoute

Informazioni di riferimento sulle funzioni helper IP

Pagina iniziale dell'helper IP

IPAddr

MIB_BEST_IF

Tipi di dati Windows