次の方法で共有


wiasReadMultiple 関数 (wiamdef.h)

wiasReadMultiple 関数は、WIA 項目から複数のプロパティ値を取得します。

構文

HRESULT wiasReadMultiple(
  [in]            BYTE           *pWiasContext,
                  ULONG          ulCount,
  [in]            const PROPSPEC *ps,
  [out]           PROPVARIANT    *pv,
  [out, optional] PROPVARIANT    *pvOld
);

パラメーター

[in] pWiasContext

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

ulCount

読み取るプロパティの数を指定します。

[in] ps

読み取るプロパティを含む、PROPSPEC 構造体の配列の最初の要素へのポインター。

[out] pv

PROPVARIANT 構造体の配列の最初 要素へのポインター。 返されると、これらの構造体にはプロパティの新しい値が含まれます。

[out, optional] pvOld

ミニドライバーによって以前に割り当てられた PROPVARIANT 構造体の配列の最初の要素へのポインター。 返されると、配列にはプロパティ データの前の値が含まれます。 この情報が不要な場合は、このパラメーターを NULL 設定できます。

戻り値

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

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

備考

この関数は、WIA 項目から複数のプロパティを読み取ります。 呼び出しが成功した場合、ミニドライバーは、pv パラメーターで指定された配列内の各要素に PropVariantClear を呼び出す必要があります。 詳細については、IPropertyStorage::ReadMultipleを参照してください。

必要条件

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

関連項目

wiasWriteMultiple