通过

NETRESOURCEA 结构 （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

指示枚举的范围。 这可以是以下值之一。

价值 意义
RESOURCE_CONNECTED
 与网络资源的当前连接。
RESOURCE_GLOBALNET
 所有网络资源。 这些可能或可能未连接。
RESOURCE_CONTEXT
 与用户的当前和默认网络上下文关联的网络资源。 此含义特定于提供程序。

dwType

指示资源类型。 这可以是以下值之一。

价值 意义
RESOURCETYPE_DISK
 资源是共享磁盘卷。
RESOURCETYPE_PRINT
 资源是共享打印机。
RESOURCETYPE_ANY
 资源匹配多个类型，例如打印和磁盘资源的容器，或者不是打印或磁盘的资源。

dwDisplayType

由提供程序设置以指示用户界面应用于表示此资源的显示类型。 定义了以下类型。

价值 意义
RESOURCEDISPLAYTYPE_NETWORK
 资源是网络提供程序。
RESOURCEDISPLAYTYPE_DOMAIN
 资源是服务器的集合。
RESOURCEDISPLAYTYPE_SERVER
 资源是服务器。
RESOURCEDISPLAYTYPE_SHARE
 资源是一个共享点。
RESOURCEDISPLAYTYPE_DIRECTORY
 资源是目录。
RESOURCEDISPLAYTYPE_GENERIC
 资源类型未指定。 此值由未指定资源类型的网络提供程序使用。

dwUsage

一个位掩码，指示如何枚举有关资源的信息。 仅当 dwScope 设置为RESOURCE_GLOBALNET时才定义它。 dwUsage 字段可以包含以下一个或多个标志。

价值 意义
RESOURCEUSAGE_CONNECTABLE
 可以通过调用 NPAddConnection连接到资源。 如果 dwType RESOURCETYPE_DISK，则在连接到资源后，可以使用文件系统 API（例如 FindFirstFile），FindNextFile枚举资源包含的任何文件和目录。
RESOURCEUSAGE_CONTAINER
 资源是其他资源的容器，可通过 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