NETRESOURCE
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 WNetAddConnection |
RESOURCEUSAGE_CONTAINER |
This is a
container resource; the name pointed to by the lpRemoteName member can
be passed to the WNetOpenEnum |
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