WNetEnumResourceA 函数（winnetwk.h）

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 [仅限桌面应用]
目标平台	窗户
标头	winnetwk.h
库	Mpr.lib
DLL	Mpr.dll