通过

ResUtilSetPropertyTableEx 函数 (resapi.h)

  • 项目

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

语法

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

参数

[in] hkeyClusterKey

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

[in] pPropertyTable

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

Reserved

保留。

[in] bAllowUnknownProperties

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

[in] pInPropertyList

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

[in] cbInPropertyListSize

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

[in] bForceWrite

强制将属性值写入群集数据库，即使新值与现有值相同

[out, optional] pOutParams

指向用于保存返回的数据 的参数块 的指针。 指定此为指针时，仅将不同于输入缓冲区中的参数写入参数块。

返回值

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

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

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

注解

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

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

要求

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

另请参阅

RESUTIL_PROPERTY_ITEM

ResUtilSetPropertyTable