NETRESOURCE

This structure that holds the network resource data. It is returned during enumeration of resources on the network and during enumeration of currently connected resources.

At a Glance

Header file: Winnetwk.h
Windows CE versions: 2.0 and later

Syntax

typedef struct _NETRESOURCE {
DWORD
dwScope;
DWORD
dwType;
DWORD
dwDisplayType;
DWORD
dwUsage;
LPTSTR
lpLocalName;
LPTSTR
lpRemoteName;
LPTSTR
lpComment;
LPTSTR
lpProvider;
} NETRESOURCE;

Members

dwScope

Specifies the scope of the enumeration. Currently, this member can be one of the following values:

Value Description
RESOURCE_CONNECTED Currently connected resources (the dwUsage member is undefined).
RESOURCE_GLOBALNET Resources on the network.
RESOURCE_REMEMBERED Remembered (persistent) connections (dwUsage is undefined).

dwType

Specifies a bitmask that gives the resource type. Currently, this member can be one of the following values:

Value Description
RESOURCETYPE_ANY All resources
RESOURCETYPE_DISK Disk resources
RESOURCETYPE_PRINT Print resources

dwDisplayType

Specifies how the network object should be displayed in a network browsing user interface. Currently, this member can be the following values:

Value Description
RESOURCEDISPLAYTYPE_DOMAIN The object should be displayed as a domain.
RESOURCEDISPLAYTYPE_GENERIC The method used to display the object does not matter.
RESOURCEDISPLAYTYPE_SERVER The object should be displayed as a server.
RESOURCEDISPLAYTYPE_SHARE The object should be displayed as a share.

dwUsage

Specifies a bitmask that gives the resource usage. This member is defined only if dwScope is RESOURCE_GLOBALNET. Currently, this member can be one of the following values:

Value Description
RESOURCEUSAGE_CONNECTABLE This is a connectable resource; the name pointed to by the lpRemoteName member can be passed to the WNetAddConnection function to make a network connection.
RESOURCEUSAGE_CONTAINER This is a container resource; the name pointed to by the lpRemoteName member can be passed to the WNetOpenEnum function to enumerate the resources in the container.

lpLocalName

Long pointer to the local name of a network resource if the dwScope member is RESOURCE_CONNECTED or RESOURCE_REMEMBERED. This member is NULL if the connection does not have a local name.

lpRemoteName

Long pointer to a remote network name if the entry is a network resource.

If the entry is a current or persistent connection, lpRemoteName points to the network name associated with the name pointed to by the lpLocalName member.

lpComment

Long pointer to a provider-supplied comment.

lpProvider

Long pointer to the name of the provider owning this resource. This member can be NULL if the provider name is unknown.

Remarks

Windows CE does not support paths with the prefix of “drive letters.” The lpLocalName member can contain any string of up to 99 characters long. If the local name is “*”, the default name is constructed based on the remote name: “<share> on <server>.”