Funzione GetAdapterIndex (iphlpapi.h)

Articolo
03/05/2024

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