Funzione GetPerAdapterInfo (iphlpapi.h)

Articolo
03/05/2024

La funzione GetPerAdapterInfo recupera informazioni sull'adattatore corrispondente all'interfaccia specificata.

Sintassi

IPHLPAPI_DLL_LINKAGE DWORD GetPerAdapterInfo(
  [in]  ULONG                IfIndex,
  [out] PIP_PER_ADAPTER_INFO pPerAdapterInfo,
  [in]  PULONG               pOutBufLen
);

Parametri

[in] IfIndex

Indice di un'interfaccia. La funzione GetPerAdapterInfo recupera informazioni per l'adapter corrispondente a questa interfaccia.

[out] pPerAdapterInfo

Puntatore a una struttura IP_PER_ADAPTER_INFO che riceve informazioni sull'adapter.

[in] pOutBufLen

Puntatore a una variabile ULONG che specifica le dimensioni della struttura IP_PER_ADAPTER_INFO . Se questa dimensione non è sufficiente per contenere le informazioni, GetPerAdapterInfo compila questa variabile con le dimensioni necessarie e restituisce un codice di errore di ERROR_BUFFER_OVERFLOW.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_BUFFER_OVERFLOW	Le dimensioni del buffer indicate dal parametro pOutBufLen sono troppo piccole per contenere le informazioni sull'adattatore. Il parametro pOutBufLen punta alle dimensioni necessarie.
ERROR_INVALID_PARAMETER	Il parametro pOutBufLen è NULL o il processo chiamante non dispone dell'accesso in lettura/scrittura alla memoria a cui punta pOutBufLen oppure il processo chiamante non dispone dell'accesso in scrittura alla memoria a cui punta il parametro pAdapterInfo .
ERROR_NOT_SUPPORTED	GetPerAdapterInfo non è supportato dal sistema operativo in esecuzione nel computer locale.
Altri	Se la funzione ha esito negativo, usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

Un indice dell'adattatore può cambiare quando l'adattatore è disabilitato e quindi abilitato o in altre circostanze e non deve essere considerato persistente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	iphlpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll

Vedi anche

Informazioni di riferimento sulla funzione helper IP

Pagina iniziale dell'helper IP

IP_PER_ADAPTER_INFO

Condividi tramite