wiasReadPropStr 関数 (wiamdef.h)

wiasReadPropStr 関数は、WIA 項目から文字列プロパティ値を取得します。

構文

HRESULT wiasReadPropStr(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           BSTR   *pbstr,
  [out, optional] BSTR   *pbstrOld,
                  BOOL   bMustExist
);

パラメーター

[in] pWiasContext

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

propid

プロパティ識別子を指定します。

[out] pbstr

プロパティの文字列値の最初のバイトを受け取るメモリ位置へのポインター。

[out, optional] pbstrOld

プロパティの前の値の最初のバイトを受け取るメモリ位置へのポインター。 この情報が必要ない場合は、このパラメーターを NULL に設定 します。

bMustExist

プロパティが存在する必要があるかどうかを示します。 TRUE に設定する場合は、 プロパティが存在する必要があります。FALSE に設定されている場合、プロパティは存在する必要はありません。

戻り値

成功すると、関数はS_OKを返します。 関数が失敗した場合は、標準 COM エラーまたは WIA_ERROR_XXX エラーのいずれかが返されます (Microsoft Windows SDKのドキュメントで説明されています)。

注釈

ミニドライバーがこの関数から受け取った文字列を使用して完了したら、文字列に使用されるメモリの割り当てを解除する必要があります。

要件

こちらもご覧ください

wiasReadPropBin

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropLong

wiasWritePropStr