NETRESOURCE (Compact 7)

  • Article

3/12/2014

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 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 Embedded Compact 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

Header

winnetwk.h

See Also

Reference

Windows Networking API/Redirector Structures
WNetOpenEnum