NETRESOURCE  HSBGYE 

The NETRESOURCE structure is returned during enumeration of resources on the network and during enumeration of currently connected resources.

typedef struct _NETRESOURCE {   // nr

    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

Meaning

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

Meaning

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

Meaning

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

 

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

Meaning

RESOURCEUSAGE_CONNECTABLE

This is a connectable resource; the name pointed to by the lpRemoteName member can be passed to the WNetAddConnection1NKK0YR 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 WNetOpenEnum1GQX7GY function to enumerate the resources in the container.

 

lpLocalName

Points to the name of a local device if the dwScope member is RESOURCE_CONNECTED or RESOURCE_REMEMBERED. This member is NULL if the connection does not use a device. Otherwise, it is undefined.

lpRemoteName

Points 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

Points to a provider-supplied comment.

lpProvider

Points to the name of the provider owning this resource. This member can be NULL if the provider name is unknown.

 

See Also

WNetAddConnection, WNetCloseEnum, WNetEnumResource, WNetOpenEnum