Funzione WNetGetNetworkInformationA (winnetwk.h)

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

Vedi anche

NETINFOSTRUCT

NETRESOURCE

WNetEnumResource

WNetGetProviderName

WNetOpenEnum

Panoramica di Windows Networking (WNet)

Funzioni di rete di Windows