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) |