通过

ClusterNetInterfaceEnum 函数 (clusapi.h)

  • 项目

枚举群集上安装的 网络接口 ，每次调用返回一个名称。

语法

DWORD ClusterNetInterfaceEnum(
  [in]      HNETINTERFACEENUM hNetInterfaceEnum,
  [in]      DWORD             dwIndex,
  [out]     LPWSTR            lpszName,
  [in, out] LPDWORD           lpcchName
);

参数

[in] hNetInterfaceEnum

ClusterNetInterfaceOpenEnum 函数最初返回的现有枚举对象的句柄。

[in] dwIndex

用于标识要枚举的条目的索引。 对于第一次调用，此参数应为零，然后针对每个后续调用递增。

[out] lpszName

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含返回的对象的名称。

[in, out] lpcchName

指向 lpszName 缓冲区的大小（以字符为单位）的指针。 输入时，指定缓冲区可以容纳的最大字符数，包括终止 NULL。 输出时，指示生成的名称中的字符数，不包括终止 NULL。

返回值

函数返回以下值之一。

返回代码/值 说明
ERROR_SUCCESS
0
 操作已成功完成。
ERROR_NO_MORE_ITEMS
259 (0x103)
 没有更多可用数据。 如果没有更多要返回的对象，则返回此值。
ERROR_MORE_DATA
234 (0xEA)
 更多数据可用。 如果 lpszName 指向的缓冲区不够大，无法保存结果，则返回此值。 lpcchName 参数返回结果中的字符数，不包括终止 NULL。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2016
目标平台 Windows
标头 clusapi.h
Library ClusAPI.lib
DLL ClusAPI.dll