wiasGetPropertyAttributes 関数 (wiamdef.h)

wiasGetPropertyAttributes 関数は、一連のプロパティのアクセス フラグと有効な値を取得します。

構文

HRESULT wiasGetPropertyAttributes(
  [in]  BYTE        *pWiasContext,
        LONG        cPropSpec,
  [in]  PROPSPEC    *pPropSpec,
        ULONG       *pulAccessFlags,
  [out] PROPVARIANT *pPropVar
);

パラメーター

[in] pWiasContext

WIA 項目コンテキストへのポインター。

cPropSpec

プロパティの数を指定します。

[in] pPropSpec

有効な値とアクセス フラグを取得するプロパティを示す PROPSPEC 構造体へのポインター。

pulAccessFlags

プロパティのアクセス フラグを含む配列へのポインター。

[out] pPropVar

プロパティの有効な値を含む PROPVARIANT 構造体の配列へのポインター。

戻り値

成功すると、関数はS_OKを返します。

関数が失敗した場合は、標準 COM エラーまたは WIA エラー コードのいずれかが返されます。

注釈

この関数は 、pPropVar 配列の各要素に、対応するプロパティの有効な値を指定する PROPVARIANT 構造体を格納します。 アクセス権フラグを持つプロパティWIA_PROP_NONE、そのプロパティに有効な値がありません。 これらのプロパティの有効な値のデータ型はVT_EMPTY。

pulAccessFlags 配列の各要素で、1 つ以上のWIA_PROP_Xxxプロパティ属性とアクセス フラグを返すことができます。

プロパティに有効な値の範囲がある場合は、この関数の完了時に pPropVar パラメーターを使用して値を決定できます。 pPropVar パラメーターは、PROPVARIANT 構造体の配列を指定します。

範囲内の有効な整数と浮動小数点の値には、次のインデックス定数を使用してアクセスします。

有効な値のインデックス	説明
WIA_RANGE_MIN	最小値
WIA_RANGE_NOM	名目値
WIA_RANGE_MAX	最大値
WIA_RANGE_STEP	増分値

有効なリスト値には、次のインデックス定数を使用してアクセスします。

有効な値のインデックス	説明
WIA_LIST_COUNT	名目値をカウントしない、有効なリスト値の数
WIA_LIST_NOM	名目値
WIA_LIST_VALUES	最初の有効な値へのインデックス

有効なビットごとのフラグ値には、次のインデックス定数を使用してアクセスします。

有効な値のインデックス	説明
WIA_FLAG_NOM	名目値
WIA_FLAG_VALUES	有効なすべてのフラグは、OR 演算子によって結合されます

要件

要件	値
対象プラットフォーム	デスクトップ
Header	wiamdef.h (Wiamdef.h を含む)
Library	Wiaservc.lib
[DLL]	Wiaservc.dll