NETINFOSTRUCT Structure

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

cbStructure

The size of the NETINFOSTRUCT structure in bytes. This 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 can have one of the following values:

WN_SUCCESS	The network is up and running.
WN_NO_NETWORK	The network is not currently running.
WN_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 can have one or more of the following bit values:

NETINFO_DLL16	The network provider is running as a 16 bit Winnet 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 Winnet driver for the network.

wNetType

A network type unique to the network being run. This value is used to associate resources with a specific network when they are made persistent, or stored in links.

dwPrinters

A bit mask indicating the valid print numbers for redirecting local printer devices, with the lowest order bit correspondinding to LPT1. A network may support more print numbers than indicated here. This mask does not take into account non-network related reasons that could stop the local printer device from being redirected (for example, having a local printer connected to the device).

dwDrives

A 32 bit mask indicating the valid local disk devices for redirecting disk drives, with the lowest order bit correspondinding to A:. This mask does not take into account non-network related reasons that could stop the disk drive from being redirected (for example, having a RAM drive assigned to the device).

• WN_SUCCESS if the call is successful.