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のドキュメントで説明されています)。
注釈
ミニドライバーがこの関数から受け取った文字列を使用して完了したら、文字列に使用されるメモリの割り当てを解除する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Microsoft Windows Me および Windows XP 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| 対象プラットフォーム | デスクトップ |
| Header | wiamdef.h (Wiamdef.h を含む) |
| Library | Wiaservc.lib |
| [DLL] | Wiaservc.dll |