CWiauPropertyList::D efineProperty 方法 (wiautil.h)
CWiauPropertyList::D efineProperty 方法會將屬性定義新增至屬性清單物件。
語法
HRESULT DefineProperty(
int *pIdx,
PROPID PropId,
LPOLESTR PropName,
ULONG Access,
ULONG SubType
);
參數
pIdx
接收新加入屬性之索引的記憶體位置指標。 這個類別中的許多其他方法會使用屬性的索引來識別 屬性。
PropId
指定屬性識別碼常數。
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) |