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。
如果操作失败,函数将返回 系统错误代码。 下面是可能的错误代码。
返回代码 | 说明 |
---|---|
|
数据的格式不正确。 |
注解
ResUtilGetDwordProperty 实用工具函数验证 pdwOutValue 中返回的值是否在 dwMinimum 和 dwMaximum 指定的范围内。 如果 dwMinimum 和 dwMaximum 都设置为 0,则不执行任何范围检查。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2008 企业版、Windows Server 2008 Datacenter |
目标平台 | Windows |
标头 | resapi.h |
Library | ResUtils.lib |
DLL | ResUtils.dll |