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。
如果操作失败,函数将返回 系统错误代码。 下面是可能的错误代码。
返回代码 | 说明 |
---|---|
|
一个或多个输入参数无效。 |
|
分配内存时出错。 |
注解
使用 ResUtilGetPropertiesToParameterBlock 实用工具函数, pPropertyTable 指向的属性表可以包含默认值。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2008 企业版、Windows Server 2008 Datacenter |
目标平台 | Windows |
标头 | resapi.h |
Library | ResUtils.lib |
DLL | ResUtils.dll |