NETINFOSTRUCT

The NETINFOSTRUCT structure is used in the WNetGetNetworkInformation function to describe the behavior of the network.

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

Members

cbStructure
The size, in bytes, of the NETINFOSTRUCT structure. The amount is filled in by the caller to indicate the size of the structure passed in. Upon return, it has the size of the structure filled in.
dwProviderVersion
The version number of the network.
dwStatus
The current status of the network provider software. This member can be one of the following values:
Value Meaning
WN_SUCCESS The network is up and running.
WN_NO_NETWORK The network is not currently running.
WN_FUNCTION_BUSY The network is not currently able to service requests, but should become available. This usually means that the network is starting up.

dwCharacteristics
Characteristics of the network provider software. This is always set to 0.

Windows 95: This member has one or more of the following bit values:

Value Meaning
NETINFO_DLL16 The network provider is running as a 16-bit Windows net driver.
NETINFO_DISKRED The network provider requires a local disk drive device redirected to access server file systems.
NETINFO_PRINTERRED The network provider requires a local printer port redirected to access server file systems.

dwHandle
The instance handle for the network provider or 16-bit Windows net driver for the network.
wNetType
A network type unique to the network being run. This value associates resources with a specific network when they are persistent or stored in links.
dwPrinters
A bit mask indicating the valid print numbers for redirecting local printer devices, with the lowest-order bit corresponding to LPT1.
Windows 95: This is always set to 0xFFFFFFFF.
dwDrives
A 32-bit mask indicating the valid local disk devices for redirecting disk drives, with the lowest order bit corresponding to A:.
Windows 95: This is always set to 0xFFFFFFFF.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Use version 2.0 or later.
  Header: Declared in winnetwk.h.

See Also

Windows Networking (WNet) Overview, Windows Networking Structures