Funzione WNetGetNetworkInformationA (winnetwk.h)

Articolo
08/27/2023

La funzione WNetGetNetworkInformation restituisce informazioni estese su un provider di rete specifico il cui nome è stato restituito da un'enumerazione di rete precedente.

Sintassi

DWORD WNetGetNetworkInformationA(
  [in]  LPCSTR          lpProvider,
  [out] LPNETINFOSTRUCT lpNetInfoStruct
);

Parametri

[in] lpProvider

Puntatore a una stringa costante con terminazione Null contenente il nome del provider di rete per cui sono necessarie informazioni.

[out] lpNetInfoStruct

Puntatore a una struttura NETINFOSTRUCT . La struttura descrive le caratteristiche della rete.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema, ad esempio uno dei valori seguenti.

Codice restituito	Descrizione
ERROR_BAD_PROVIDER	Il parametro lpProvider non corrisponde ad alcun provider di rete in esecuzione.
ERROR_BAD_VALUE	Il membro cbStructure della struttura NETINFOSTRUCT non contiene una dimensione di struttura valida.

Commenti

Nota

L'intestazione winnetwk.h definisce WNetGetNetworkInformation come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winnetwk.h
Libreria	Mpr.lib
DLL	Mpr.dll