Funzione GetBestInterfaceEx (iphlpapi.h)

Articolo
08/24/2023

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
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 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.
ERROR_NOT_SUPPORTED	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.
Altri	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