ClusterRegSetValue 函数是 Windows API 中 Failover Cluster 的一部分，用于在指定的群集注册表键中创建或修改一个值。

以下是函数的原型：
DWORD ClusterRegSetValue(
  HKEY    hKey,
  LPCWSTR lpszValueName,
  DWORD   dwType,
  const BYTE *lpData,
  DWORD   cbData
);

参数说明：

  •  hKey: 要创建或修改值的群集注册表键的句柄。

  •  lpszValueName: 要创建或修改的值的名称。

  •  dwType: 指定值的数据类型，例如 REG_SZ、REG_DWORD 等。

  •  lpData: 指向要写入的数据的指针。

  •  cbData: 要写入的数据的大小（字节数）。


函数返回值为 ERROR_SUCCESS 表示成功，其他值表示失败，并且可以使用 GetLastError 函数获取错误码。

以下是一个简单的示例：
#include <windows.h>
#include <clusapi.h>

int main() {
    HKEY hClusterKey;
    DWORD result;

    // 打开或创建群集根键
    result = ClusterRegOpenKey(HKEY_LOCAL_MACHINE, L"Cluster", KEY_WRITE, &hClusterKey);
    if (result != ERROR_SUCCESS) {
        // 处理错误
        return result;
    }

    // 设置或修改值
    result = ClusterRegSetValue(hClusterKey, L"YourValueName", REG_SZ, (const BYTE*)L"YourValueData", sizeof(L"YourValueData"));
    if (result != ERROR_SUCCESS) {
        // 处理错误
    }

    // 关闭群集根键
    ClusterRegCloseKey(hClusterKey);

    return 0;
}

请确保在使用这个函数之前，你有足够的权限来访问相应的注册表键。函数的成功与否可以通过检查返回值是否为 ERROR_SUCCESS 来判断。


转载请注明出处：http://www.pingtaimeng.com/article/detail/24425/Win32 API/Clusapi.h/ClusterRegSetValue