次の方法で共有


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のいずれかを指定します。 最初の 3 つの定数は、プロパティがフラグ値のセット、値のリスト、または値の範囲であることを示します。 4 番目の定数は、プロパティがこれらのいずれでもないことを示します。

戻り値

プロパティを正常に定義できる場合、このメソッドはS_OKを返します。 プロパティ リストに追加のプロパティ用の十分なスペースがない場合、メソッドは E_FAILを返します。

注釈

プロパティリストにプロパティを追加する前に、プロパティリストを初期化する必要があります。 これを行うには、 CWiauPropertyList::Init メソッドを呼び出します。

要件

要件
対象プラットフォーム デスクトップ
Header wiautil.h (Wiautil.h、Wiamindr.h を含む)

こちらもご覧ください

CWiauPropertyList

CWiauPropertyList::Init