Funzione GetAdapterIndex (iphlpapi.h)
La funzione GetAdapterIndex ottiene l'indice di un adattatore, in base al nome.
Sintassi
IPHLPAPI_DLL_LINKAGE DWORD GetAdapterIndex(
[in] LPWSTR AdapterName,
[in, out] PULONG IfIndex
);
Parametri
[in] AdapterName
Puntatore a una stringa Unicode che specifica il nome dell'adattatore.
[in, out] IfIndex
Puntatore a una variabile ULONG che punta all'indice dell'adattatore.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.
Se la funzione ha esito negativo, usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.
Commenti
Finché un adattatore non è completamente disabilitato, la funzione GetAdapterIndex segnala l'adapter come presente. Ad esempio, la funzione NotifyAddrChange può indicare che l'indirizzo IP di una scheda disabilitata di recente viene rimosso, ma GetAdapterIndex continua a segnalare un indice dell'adapter fino al completamento del processo di disabilitazione dell'adapter.
Quando nel sistema sono presenti uno o più adattatori, GetAdapterIndex restituisce ERROR_DEV_NOT_EXIST quando l'adattatore sottoposto a query non esiste. Quando non sono presenti adattatori, la funzione GetAdapterIndex restituisce ERROR_NO_DATA.
L'indice dell'adattatore può cambiare quando un adattatore è disabilitato e quindi abilitato o in altre circostanze e non deve essere considerato persistente.
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
Informazioni di riferimento sulle funzioni helper IP
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per