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 構造体の配列を指定します。

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

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

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

要件