Struttura NETINFOSTRUCT (winnetwk.h)

  • Articolo

La struttura NETINFOSTRUCT contiene informazioni che descrivono il provider di rete restituito dalla funzione WNetGetNetworkInformation .

Sintassi

typedef struct _NETINFOSTRUCT {
  DWORD     cbStructure;
  DWORD     dwProviderVersion;
  DWORD     dwStatus;
  DWORD     dwCharacteristics;
  ULONG_PTR dwHandle;
  WORD      wNetType;
  DWORD     dwPrinters;
  DWORD     dwDrives;
} NETINFOSTRUCT, *LPNETINFOSTRUCT;

Members

cbStructure

Tipo: DWORD

Dimensione, in byte, della struttura NETINFOSTRUCT . Il chiamante deve specificare questo valore per indicare le dimensioni della struttura passata. Al ritorno, ha le dimensioni della struttura compilata.

dwProviderVersion

Tipo: DWORD

Numero di versione del software del provider di rete.

dwStatus

Tipo: DWORD

Stato corrente del software del provider di rete. Questo membro può essere uno dei valori seguenti.

Valore Significato
NO_ERROR
 La rete è in esecuzione.
ERROR_NO_NETWORK
 La rete non è disponibile.
ERROR_BUSY
 La rete non è attualmente in grado di gestire le richieste, ma dovrebbe diventare disponibile a breve. Questo valore indica in genere che la rete viene avviata.

dwCharacteristics

Tipo: DWORD

Caratteristiche del software del provider di rete.

Questo valore è zero.

Windows Me/98/95: Questo membro può essere uno o più dei valori seguenti.

Valore Significato
NETINFO_DLL16
 Il provider di rete è in esecuzione come driver di rete Windows a 16 bit.
NETINFO_DISKRED
 Il provider di rete richiede un dispositivo di unità disco locale reindirizzato per accedere ai file system del server.
NETINFO_PRINTERRED
 Il provider di rete richiede una porta della stampante locale reindirizzata per accedere ai file system del server.

dwHandle

Tipo: ULONG_PTR

Handle di istanza per il provider di rete o per il driver di rete Windows a 16 bit.

wNetType

Tipo: WORD

Tipo di rete univoco per la rete in esecuzione. Questo valore associa le risorse a una rete specifica quando le risorse sono persistenti o archiviate nei collegamenti. È possibile trovare un elenco completo dei tipi di rete nel file di intestazione Winnetwk.h.

dwPrinters

Tipo: DWORD

Set di flag di bit che indicano i numeri di stampa validi per il reindirizzamento dei dispositivi della stampante locale, con il bit di ordine basso corrispondente a LPT1.

Windows Me/98/95: Questo valore è sempre impostato su -1.

dwDrives

Tipo: DWORD

Set di flag di bit che indicano i dispositivi disco locali validi per il reindirizzamento delle unità disco, con il bit di ordine basso corrispondente a A:.

Windows Me/98/95: Questo valore è sempre impostato su -1.

Commenti

La struttura NETINFOSTRUCT contiene informazioni che descrivono la rete, ad esempio la versione del software del provider di rete e lo stato corrente della rete.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Intestazione winnetwk.h

Vedi anche

WNetGetNetworkInformation

Panoramica di Windows Networking (WNet)

Strutture di rete Di Windows