Share via

NETRESOURCE

  • Article

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.