ResUtilGetDwordProperty 函数 (resapi.h)

属性列表中检索 DWORD 属性,并将指针前进到列表中的下一个属性。 PRESUTIL_GET_DWORD_PROPERTY类型定义指向此函数的指针。

语法

DWORD ResUtilGetDwordProperty(
  [out] LPDWORD               pdwOutValue,
  [in]  const PCLUSPROP_DWORD pValueStruct,
  [in]  DWORD                 dwOldValue,
  [in]  DWORD                 dwMinimum,
  [in]  DWORD                 dwMaximum,
  [out] LPBYTE                *ppPropertyList,
  [out] LPDWORD               pcbPropertyListSize
);

参数

[out] pdwOutValue

指针的地址,其中将返回属性列表中的 DWORD 值。

[in] pValueStruct

指向 CLUSPROP_DWORD 结构的指针,指定要从属性列表中检索的 DWORD 值。

[in] dwOldValue

指定 属性的上一个值。

[in] dwMinimum

指定属性允许的最小值。

[in] dwMaximum

指定属性允许的最大值。

[out] ppPropertyList

指向包含 DWORD 属性的属性列表缓冲区的指针的地址。 此指针将前进到下一个属性的开头。

[out] pcbPropertyListSize

指向属性列表缓冲区大小的指针。 大小将递减,以考虑 ppPropertyList 指针的前进。

返回值

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

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

返回代码 说明
ERROR_INVALID_PARAMETER
数据的格式不正确。

注解

ResUtilGetDwordProperty 实用工具函数验证 pdwOutValue 中返回的值是否在 dwMinimumdwMaximum 指定的范围内。 如果 dwMinimumdwMaximum 都设置为 0,则不执行任何范围检查。

要求

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

另请参阅

ResUtilGetBinaryProperty

ResUtilGetMultiSzProperty

ResUtilGetSzProperty