NETRESOURCE (winnetwk.h)
以下结构包含有关网络资源的信息。 它由多个网络提供程序函数使用,包括 NPOpenEnum 和 NPAddConnection。
语法
typedef struct _NETRESOURCEA {
DWORD dwScope;
DWORD dwType;
DWORD dwDisplayType;
DWORD dwUsage;
LPSTR lpLocalName;
LPSTR lpRemoteName;
LPSTR lpComment;
LPSTR lpProvider;
} NETRESOURCEA, *LPNETRESOURCEA;
成员
dwScope
指示枚举的范围。 这可以是以下值之一。
值 | 含义 |
---|---|
|
与网络资源的当前连接。 |
|
所有网络资源。 这些可能已连接,也可能未连接。 |
|
与用户的当前和默认网络上下文关联的网络资源。 其含义特定于提供程序。 |
dwType
指示资源类型。 这可以是以下值之一。
值 | 含义 |
---|---|
|
资源是共享磁盘卷。 |
|
资源是共享打印机。 |
|
资源匹配多个类型,例如打印和磁盘资源的容器,或者既不是打印资源也不是磁盘的资源。 |
dwDisplayType
由提供程序设置以指示用户界面应使用哪种显示类型来表示此资源。 定义了以下类型。
dwUsage
一个位掩码,指示如何枚举有关资源的信息。 仅当 dwScope 设置为 RESOURCE_GLOBALNET 时才定义它。 dwUsage 字段可以包含以下一个或多个标志。
值 | 含义 |
---|---|
|
可以通过调用 NPAddConnection 连接到资源。 如果 dwType RESOURCETYPE_DISK,则在连接到资源后,可以使用文件系统 API(如 FindFirstFile 和 FindNextFile)枚举资源包含的任何文件和目录。 |
|
资源是可通过 NPOpenEnum、NPEnumResource 和 NPCloseEnum 函数枚举的其他资源的容器。
但是,在进行枚举时,容器可能为空。 换句话说,对 NPEnumResource 的第一次调用可能会返回WN_NO_MORE_ENTRIES。 |
lpLocalName
如果 dwScope RESOURCE_CONNECTED,则 lpLocalName 字段包含重定向设备的名称。 如果连接是无设备连接,则此字段包含 NULL。
如果未将 dwScope 设置为 RESOURCE_CONNECTED,则此字段未定义。
lpRemoteName
如果枚举项是网络资源,则此字段包含远程网络名称。 如果 dwUsage 设置为 RESOURCEUSAGE_CONNECTABLE,则可以将此名称传递给 NPAddConnection 以建立网络连接。 如果枚举项是当前连接,则此字段将引用 lpLocalName 连接到的远程网络名称。
lpComment
可以是与枚举项关联的任何提供程序提供的注释。
lpProvider
指定拥有此枚举项的提供程序的名称。
注解
注意
winnetwk.h 标头将 NETRESOURCE 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
标头 | winnetwk.h |