Funzione GetBestInterfaceEx (iphlpapi.h)
La funzione GetBestInterfaceEx recupera l'indice dell'interfaccia con la route migliore per l'indirizzo IPv4 o IPv6 specificato.
Sintassi
IPHLPAPI_DLL_LINKAGE DWORD GetBestInterfaceEx(
[in] sockaddr *pDestAddr,
[out] PDWORD pdwBestIfIndex
);
Parametri
[in] pDestAddr
Indirizzo IPv6 o IPv4 di destinazione per il quale recuperare l'interfaccia con la route migliore, sotto forma di struttura sockaddr .
[out] pdwBestIfIndex
Puntatore all'indice dell'interfaccia con la route migliore all'indirizzo IPv6 o IPv4 specificato da pDestAddr.
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 |
|---|---|
|
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 i parametri pDestAddr o pdwBestIfIndex puntano alla memoria a cui non è possibile accedere. Questo errore può essere restituito anche se il parametro pdwBestIfIndex punta alla memoria in cui non è possibile scrivere. |
|
La richiesta non è supportata. Questo errore viene restituito se non si trova alcun stack IPv4 nel computer locale e nel parametro pDestAddr è stato specificato un indirizzo IPv4 o nel parametro pDestAddr non è presente alcun stack IPv6 e nel parametro pDestAddr è stato specificato un indirizzo IPv6. |
|
Utilizzare la funzione FormatMessage per ottenere la stringa di messaggio per l'errore restituito. |
Commenti
La funzione GetBestInterfaceEx è diversa dalla funzione GetBestInterface in quanto può essere usata con indirizzi IPv4 o IPv6.
Il membro Family della struttura sockaddr a cui punta il parametro pDestAddr deve essere impostato su uno dei valori seguenti: AF_INET o AF_INET6.
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
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | iphlpapi.h |
| Libreria | Iphlpapi.lib |
| DLL | Iphlpapi.dll |
Vedi anche
Informazioni di riferimento sulle funzioni helper IP