ResUtilGetPropertiesToParameterBlock 函数 (resapi.h)

群集数据库中检索由属性表指定的属性,并在参数块中返回这些属性。

语法

DWORD ResUtilGetPropertiesToParameterBlock(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out]           LPBYTE                       pOutParams,
  [in]            BOOL                         bCheckForRequiredProperties,
  [out, optional] LPWSTR                       *pszNameOfPropInError
);

参数

[in] hkeyClusterKey

指向群集数据库密钥的指针,该密钥标识要检索的属性的位置。

[in] pPropertyTable

指向描述要处理的属性的 RESUTIL_PROPERTY_ITEM 结构的数组的指针。

[out] pOutParams

指向要填充的输出参数块的指针。

[in] bCheckForRequiredProperties

指定在缺少所需属性时是否应生成错误。

[out, optional] pszNameOfPropInError

字符串指针的地址,其中要返回由缺少的必需属性生成的错误的名称。 ppszNameOfPropInError 属性是可选的。

返回值

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

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

返回代码 说明
ERROR_BAD_ARGUMENTS
一个或多个输入参数无效。
ERROR_NOT_ENOUGH_MEMORY
分配内存时出错。

注解

使用 ResUtilGetPropertiesToParameterBlock 实用工具函数, pPropertyTable 指向的属性表可以包含默认值。

要求

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

另请参阅

RESUTIL_PROPERTY_ITEM