Funzione WNetGetNetworkInformationA (winnetwk.h)

Articolo
11/20/2024

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 con terminazione Null costante 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 è 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.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winnetwk.h
libreria	Mpr.lib
dll	Mpr.dll