Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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.

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 dwUsagemember is undefined).

RESOURCE_GLOBALNET

Resources on the network.

RESOURCE_REMEMBERED

Remembered (persistent) connections ( dwUsageis 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 dwScopeis 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 lpRemoteNamemember can be passed to the WNetAddConnectionfunction to make a network connection.

RESOURCEUSAGE_CONTAINER

This is a container resource; the name pointed to by the lpRemoteNamemember can be passed to the WNetOpenEnumfunction to enumerate the resources in the container.
lpLocalName

Long pointer to the local name of a network resource if the dwScopemember 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, lpRemoteNamepoints to the network name associated with the name pointed to by the lpLocalNamemember.

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 Embedded CE does not support paths with the prefix of "drive letters." The lpLocalNamemember can contain any string of up to 64 characters long. If the local name is "*", the default name is constructed based on the remote name: "<share> on <server>."

Requirements

Header winnetwk.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

WNetOpenEnum