CWiauPropertyList::D efineProperty 方法 (wiautil.h)
CWiauPropertyList::D efineProperty 方法向属性列表对象添加属性定义。
语法
HRESULT DefineProperty(
int *pIdx,
PROPID PropId,
LPOLESTR PropName,
ULONG Access,
ULONG SubType
);
参数
pIdx
指向接收新添加属性索引的内存位置的指针。 此类中的许多其他方法都使用属性的索引来标识属性。
PropId
指定属性 ID 常量。
PropName
指向属性的名称字符串的指针。
Access
指定属性的访问类型,通常是WIA_PROP_READ(只读)或WIA_PROP_RW(可读/写)。
SubType
指定属性子类型、WIA_PROP_FLAG、WIA_PROP_LIST、WIA_PROP_RANGE或WIA_PROP_NONE之一。 前三个常量分别指示属性是一组标志值、值列表或值范围。 第四个常量指示属性不是这些属性。
返回值
如果此方法能够成功定义属性,此方法将返回S_OK。 如果属性列表没有足够的空间用于其他属性,该方法将返回E_FAIL。
言论
必须先初始化属性列表,然后才能将属性添加到属性列表中。 为此,请调用 CWiauPropertyList::Init 方法。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | wiautil.h (包括 Wiautil.h、Wiamindr.h) |