ResUtilSetPropertyTable 函数 (resapi.h)

基于属性表中的属性列表设置群集数据库中的属性。

语法

DWORD ResUtilSetPropertyTable(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
                  PVOID                        Reserved,
  [in]            BOOL                         bAllowUnknownProperties,
  [in]            const PVOID                  pInPropertyList,
  [in]            DWORD                        cbInPropertyListSize,
  [out, optional] LPBYTE                       pOutParams
);

参数

[in] hkeyClusterKey

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

[in] pPropertyTable

指向描述要设置的属性的 RESUTIL_PROPERTY_ITEM 结构的数组的指针。

Reserved

保留。

[in] bAllowUnknownProperties

指示是否应接受 未知属性 。 如果应接受此参数，则将其设置为 TRUE ;否则，此参数设置为 FALSE 。

[in] pInPropertyList

指向包含属性列表的输入缓冲区的指针。

[in] cbInPropertyListSize

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

[out, optional] pOutParams

指向用于保存返回的数据 的参数块 的指针。 如果指定了参数，则仅当参数与输入缓冲区中的参数不同时才写入。

返回值

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

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

返回代码	说明
ERROR_BAD_ARGUMENTS	一个或多个输入参数无效。
ERROR_INSUFFICIENT_BUFFER	cbInPropertyListSize 中指定的输入缓冲区的大小太小。
ERROR_INVALID_DATA	pInPropertyList 指向的输入缓冲区为 NULL、属性名称无效或属性值太小。
ERROR_INVALID_PARAMETER	pPropertyTable 指向的属性表中属性的语法、格式或类型不正确，或者属性是只读的，无法设置。

注解

如果群集数据库中已存在属性表中指定的值，则不会写入该值。 有关强制写入所有值的信息，请参阅 ResUtilSetPropertyTableEx。

不要从以下资源 DLL 入口点函数调用 ResUtilSetPropertyTable 。

• 关闭
• Offline
• 联机
• 打开
• Terminate

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

要求

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

另请参阅

RESUTIL_PROPERTY_ITEM

ResUtilSetPropertyTableEx