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 演算子によって結合されます

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	wiamdef.h (Wiamdef.h を含む)
ライブラリ	Wiaservc.lib
DLL	Wiaservc.dll