WNetEnumResourceA 函数 (winnetwk.h)

项目
08/27/2023

WNetEnumResource 函数继续枚举通过调用 WNetOpenEnum 函数启动的网络资源。

语法

DWORD WNetEnumResourceA(
  [in]      HANDLE  hEnum,
  [in, out] LPDWORD lpcCount,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

参数

[in] hEnum

标识枚举实例的句柄。此句柄必须由 WNetOpenEnum 函数返回。

[in, out] lpcCount

指向指定所请求条目数的变量的指针。如果请求的数字为 –1，则函数返回尽可能多的条目。

如果函数成功，则返回时，此参数指向的变量包含实际读取的条目数。

[out] lpBuffer

指向接收枚举结果的缓冲区的指针。结果作为 NETRESOURCE 结构的数组返回。请注意，分配的缓冲区必须足够大，以便保存结构及其成员指向的字符串。有关更多信息，请参见下面的“备注”部分。

缓冲区一直有效，直到使用 hEnum 参数指定的句柄进行下一次调用。 数组中 NETRESOURCE 结构的顺序不可预测。

[in, out] lpBufferSize

指向变量的指针，该变量指定 lpBuffer 参数的大小（以字节为单位）。如果缓冲区太小，甚至无法接收一个条目，则此参数将接收所需的缓冲区大小。

返回值

如果函数成功，则返回值为以下值之一。

返回代码	说明
NO_ERROR	枚举成功，缓冲区包含请求的数据。调用应用程序可以继续调用 WNetEnumResource 来完成枚举。
ERROR_NO_MORE_ITEMS	不再有条目。缓冲区内容未定义。

如果函数失败，则返回值为系统错误代码，例如以下值之一。

返回代码	说明
ERROR_MORE_DATA	后续调用中有更多条目可用。有关更多信息，请参见下面的“备注”部分。
ERROR_INVALID_HANDLE	hEnum 参数指定的句柄无效。
ERROR_NO_NETWORK	网络不可用。 (在测试 hEnum 的有效性之前测试此条件。)
ERROR_EXTENDED_ERROR	发生特定于网络的错误。若要获取错误的说明，请调用 WNetGetLastError 函数。

注解

WNetEnumResource 函数不枚举连接到共享的用户;可以调用 NetConnectionEnum 函数来完成此任务。若要枚举隐藏共享，请调用 NetShareEnum 函数。

应用程序无法将 lpBuffer 参数设置为 NULL 并从 lpBufferSize 参数检索所需的缓冲区大小。相反，应用程序应分配一个大小合理的缓冲区（通常为 16 KB），并使用 lpBufferSize 的值进行错误检测。

示例

有关演示枚举网络上所有资源的应用程序定义函数的代码示例，请参阅枚举网络资源。

注意

winnetwk.h 标头将 WNetEnumResource 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winnetwk.h
Library	Mpr.lib
DLL	Mpr.dll