ClusterRegEnumKey 函数 (clusapi.h)
枚举打开的 群集数据库 密钥的子项。
语法
LONG ClusterRegEnumKey(
[in] HKEY hKey,
[in] DWORD dwIndex,
[out] LPWSTR lpszName,
[in, out] LPDWORD lpcchName,
[out, optional] PFILETIME lpftLastWriteTime
);
参数
[in] hKey
指定当前打开的密钥的 HKEY。
[in] dwIndex
用于标识要枚举的下一个子项的索引。 第一次调用 ClusterRegEnumKey 时，此参数应为零，然后针对后续调用递增。
由于子项不是有序的，因此任何新子项都具有任意索引。 这意味着 ClusterRegEnumKey 可以按任何顺序返回子项。
[out] lpszName
指向接收子项名称（包括 null 终止字符）的缓冲区的指针。 函数仅将子项的名称（而不是完整键层次结构）复制到缓冲区。
[in, out] lpcchName
指向 lpszName 缓冲区大小（以字符计数表示）的指针。 输入时，指定缓冲区可以容纳的最大字符数，包括终止 NULL。 在输出时，指定结果名称中的字符数，不包括终止 NULL。
[out, optional] lpftLastWriteTime
指向上次修改枚举子项的时间的指针。
返回值
函数返回以下值之一。
| 返回代码/值 | 说明 |
|---|---|
|
操作成功。 |
|
不再返回子项。 |
|
lpszName 指向的缓冲区不够大，无法保存结果。 lpcchName 参数返回结果中的字符数，不包括终止 NULL。 |
| 此操作失败。 |
注解
ClusterRegEnumKey 函数在每次调用时检索有关一个子项的信息。
由于将 hKey 设置为 NULL 时，ClusterRegEnumKey 枚举应用程序在其上运行的节点上的数据库的根目录中的密钥，因此如果节点不是群集的一部分，ClusterRegEnumKey 将失败。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows Server 2008 企业版、Windows Server 2008 Datacenter |
| 目标平台 | Windows |
| 标头 | clusapi.h |
| Library | ClusAPI.lib |
| DLL | ClusAPI.dll |