通过

ResUtilVerifyPropertyTable 函数 (resapi.h)

  • 项目

使用 属性表 验证 属性列表 的格式是否正确。

语法

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

参数

[in] pPropertyTable

指向描述将在属性列表中验证的属性的属性表的指针。

Reserved

此参数留待将来使用。

[in] bAllowUnknownProperties

如果 为 TRUE，则函数将忽略属性列表中未包含在属性表中的所有属性。 如果 为 FALSE，则属性列表中未包含在属性表中的任何属性都会导致函数返回 ERROR_INVALID_PARAMETER。

[in] pInPropertyList

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

[in] cbInPropertyListSize

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

[out, optional] pOutParams

指向参数块的指针。

返回值

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

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

返回代码 说明
ERROR_INSUFFICIENT_BUFFER
 属性列表缓冲区大于 cbInPropertyListSize 参数报告的缓冲区。
ERROR_INVALID_DATA
 未指定属性列表缓冲区，或者属性列表的格式不正确
ERROR_INVALID_PARAMETER
 属性列表的格式不正确。 如果 bAllowUnknownProperties 设置为 FALSE，则属性列表可能包含属性表中不存在的属性。

要求

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

另请参阅

RESUTIL_PROPERTY_ITEM