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>.