ClusterRegSetKeySecurity 函数是 Windows API 中 Failover Cluster 的一部分，用于设置指定注册表键的安全描述符（Security Descriptor）。

以下是函数的原型：
DWORD ClusterRegSetKeySecurity(
  HKEY                  hKey,
  SECURITY_INFORMATION SecurityInformation,
  PSECURITY_DESCRIPTOR pSecurityDescriptor
);

参数说明：

  •  hKey: 要设置安全描述符的注册表键的句柄。

  •  SecurityInformation: 指定安全描述符的信息类型，可以是 DACL、SACL、OWNER、GROUP 等。

  •  pSecurityDescriptor: 指向包含要设置的安全描述符的结构的指针。


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

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

int main() {
    HKEY hKey;
    DWORD result;

    // 打开注册表键
    result = RegOpenKeyEx(HKEY_LOCAL_MACHINE, L"Software\\YourRegistryPath", 0, KEY_SET_VALUE, &hKey);
    if (result != ERROR_SUCCESS) {
        // 处理错误
        return result;
    }

    // 获取当前安全描述符
    PSECURITY_DESCRIPTOR pSecurityDescriptor;
    result = ClusterRegGetKeySecurity(hKey, DACL_SECURITY_INFORMATION, NULL, NULL);
    if (result != ERROR_SUCCESS && result != ERROR_INSUFFICIENT_BUFFER) {
        // 处理错误
        RegCloseKey(hKey);
        return result;
    }

    // 分配内存并获取安全描述符
    pSecurityDescriptor = (PSECURITY_DESCRIPTOR)malloc(result);
    if (pSecurityDescriptor == NULL) {
        // 处理内存分配错误
        RegCloseKey(hKey);
        return ERROR_NOT_ENOUGH_MEMORY;
    }

    result = ClusterRegGetKeySecurity(hKey, DACL_SECURITY_INFORMATION, pSecurityDescriptor, &result);
    if (result != ERROR_SUCCESS) {
        // 处理错误
        free(pSecurityDescriptor);
        RegCloseKey(hKey);
        return result;
    }

    // 在这里修改安全描述符，例如添加或移除权限

    // 设置新的安全描述符
    result = ClusterRegSetKeySecurity(hKey, DACL_SECURITY_INFORMATION, pSecurityDescriptor);
    if (result != ERROR_SUCCESS) {
        // 处理错误
    }

    // 释放资源
    free(pSecurityDescriptor);
    RegCloseKey(hKey);

    return 0;
}

请注意，使用这个函数需要适当的权限，并且在使用之前应该确保 hKey 是有效的注册表键句柄。


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