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 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 per l'indirizzo IPv6 o IPv4 specificato da pDestAddr.
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 viene passato un puntatore NULL 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 un indirizzo IPv4 è stato specificato nel parametro pDestAddr o non è presente alcun stack IPv6 nel computer locale e un indirizzo IPv6 è stato specificato nel parametro pDestAddr . |
|
Utilizzare la funzione FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
Osservazioni:
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
| Requisito | Value |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Header | iphlpapi.h |
| Library | Iphlpapi.lib |
| DLL | Iphlpapi.dll |
Vedere anche
Informazioni di riferimento sulle funzioni helper IP