Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 |
|---|---|
|
Impossibile completare l'operazione. |
|
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. |
|
La richiesta non è supportata. Questo errore viene restituito se non è presente alcun stack IPv4 nel computer locale. |
|
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
Informazioni di riferimento sulle funzioni helper IP