通过

ResUtilSetPrivatePropertyList 函数 (resapi.h)

  • 项目

设置群集对象的私有属性。

语法

DWORD ResUtilSetPrivatePropertyList(
  [in] HKEY        hkeyClusterKey,
  [in] const PVOID pInPropertyList,
  [in] DWORD       cbInPropertyListSize
);

参数

[in] hkeyClusterKey

标识要设置的属性位置的群集数据库密钥。

[in] pInPropertyList

指向包含 属性列表的 输入缓冲区的指针，该列表包含要设置的属性的名称和值。

[in] cbInPropertyListSize

指向 pInPropertyList 指向的输入缓冲区的大小（以字节为单位）的指针。

返回值

如果操作成功，函数将返回 ERROR_SUCCESS。

如果操作失败，该函数将返回 系统错误代码。 下面是可能的错误代码。

返回代码 说明
ERROR_BAD_ARGUMENTS
 一个或多个输入参数无效。
ERROR_INVALID_DATA
 属性的数据长度存在问题。
ERROR_INSUFFICIENT_BUFFER
 pInPropertyList 指向的输入缓冲区为 NULL。
ERROR_INVALID_PARAMETER
 属性名称的语法无效。

注解

在 ResUtilSetPrivatePropertyList 实用工具函数中设置的属性放置在群集数据库的指定键下方的一部分，该对象的指定键与属性列表中的名称完全一致。 如果属性的名称包含反斜杠字符 (\) ，则反斜杠字符前面的每个字符串将解释为子项名称，最后一个反斜杠字符后面的最后一个字符串将解释为值名称。

不要从以下资源 DLL 入口点函数调用 ResUtilSetPrivatePropertyList ：

可以从任何其他资源 DLL 入口点函数或工作线程安全地调用 ResUtilSetPrivatePropertyList。 有关详细信息，请参阅 在资源 DLL 中对避免的函数调用。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目标平台 Windows
标头 resapi.h
Library ResUtils.lib
DLL ResUtils.dll

另请参阅

ResUtilVerifyPrivatePropertyList