ClusterRegCreateKey 函数是 Windows 集群编程中的一个函数,用于创建或打开群集注册表中的一个注册表项。以下是该函数的一般形式:
LONG ClusterRegCreateKey(
  HKEY   hKey,
  LPCWSTR lpSubKey,
  DWORD  dwOptions,
  REGSAM samDesired,
  PHKEY  phkResult,
  LPDWORD lpdwDisposition
);

参数说明:
  •  hKey:父项的句柄,可以是 HKEY_LOCAL_MACHINE 或从 ClusterRegOpenKey 获得的句柄。

  •  lpSubKey:注册表路径,相对于 hKey。

  •  dwOptions:选项,指定操作的类型。可以是 CLUSREG_KEY_NOT_SHARED。

  •  samDesired:访问权限。

  •  phkResult:输出参数,用于接收新创建或已打开项的句柄。

  •  lpdwDisposition:输出参数,指示项是新创建的还是已存在的。


函数返回一个 LONG 类型的错误代码。如果函数成功,返回值为 ERROR_SUCCESS。

示例代码:
#include <windows.h>
#include <ClusAPI.h>

int main() {
    HCLUSTER hCluster = OpenCluster(L"ClusterName");
    if (hCluster != NULL) {
        HKEY hKey = NULL;
        DWORD disposition;

        // 创建或打开注册表项
        LONG result = ClusterRegCreateKey(
            hCluster,
            L"Software\\MyClusterApp",
            0,
            KEY_READ | KEY_WRITE,
            &hKey,
            &disposition
        );

        if (result == ERROR_SUCCESS) {
            // 成功创建或打开注册表项,可以进行操作

            // 关闭注册表项
            ClusterRegCloseKey(hKey);
        }

        CloseCluster(hCluster);
    }

    return 0;
}

请注意,此函数用于在群集注册表中创建或打开项,而不是在本地注册表中。如果在本地注册表中创建或打开项,请使用 RegCreateKeyEx 函数。


转载请注明出处:http://www.zyzy.cn/article/detail/24415/Win32 API/Clusapi.h/ClusterRegCreateKey