NETINFOSTRUCT info  Overview  Group

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.