Index   Commented   Search   About

Overview
Group
Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
-
Header File
winnetwk.h
Unicode
WinNT
Platform Notes
None

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

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

Related Links

Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET

More Online Helps

Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages

Free Tech Secrets ;) Copyright © 2008 Free Tect Secrets ;) greatis just4fun network just4fun