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.

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 64 characters long. If the local name is "*", the default name is constructed based on the remote name: "<share> on <server>."

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Winnetwk.h.

See Also

WNetOpenEnum

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.