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)

另請參閱

CWiauPropertyList

CWiauPropertyList::Init