次の方法で共有

IWiaAppErrorHandler::ReportStatus メソッド

  • [アーティクル]

イメージ データ転送中にデバイスの状態とエラー メッセージを処理し、ユーザーにメッセージを表示します。

構文

HRESULT ReportStatus(
  [in] LONG      lFlags,
  [in] IWiaItem2 *pWiaItem2,
  [in] HRESULT   hrStatus,
  [in] LONG      lPercentComplete
);

パラメーター

lFlags [in]

型: LONG

使用しません。 0 に設定されます。

pWiaItem2 [in]

種類: IWiaItem2*

転送されるアイテムへのポインター。

hrStatus [in]

種類: HRESULT

デバイスの状態コード。

lPercentComplete [in]

型: LONG

現在の操作の完了率。

戻り値

種類: HRESULT

エラーからの復旧が不可能な場合は 、hrStatus を返します。 それ以外の場合は、次のいずれかの値が返されます。

リターン コード 説明
S_OK
 hrStatus がエラーの場合は、エラーを修正するための適切なアクションが実行され、転送を続行できます。 hrStatus が情報的な場合、ユーザーはモードレス ダイアログ ボックスで通知され、転送をキャンセルしないことを選択しました。
S_FALSE
 ユーザーは、エラー ハンドラー のモードレス ダイアログ ボックスから転送を取り消しました。 この値は、 hrStatus が何であっても、任意の時点で返すことができます。
WIA_STATUS_NOT_HANDLED
 アクションは実行されませんでした。つまり、ユーザーにダイアログ ボックスが表示されませんでした。 次のエラー ハンドラーが呼び出されます。 エラー ハンドラーの順序は、アプリケーション、ドライバー、システムの既定値です。

 

注釈

lPercentComplete パラメーターを使用すると、エラー ハンドラー ウィンドウで進行状況を表示できます。 たとえば、ドライバーは、"ウォームアップ" にかかる時間の見積もりを提供する場合があります。 IWiaAppErrorHandler::ReportStatus に渡される lPercentComplete パラメーターは、ドライバーが WiaTransferParams 構造体に設定する lPercentComplete と同じ値です。

エラー ハンドラーでは、SUCCEEDED マクロと FAILED マクロを使用して、 hrStatus にSEVERITY_ERRORまたはSEVERITY_SUCCESSがあるかどうかを確認できます。

hrStatus がSEVERITY_SUCCESSされている場合は、ユーザーに転送の取り消しを許可する必要があります。

hrStatus がSEVERITY_ERROR場合、エラー ハンドラーには、アプリケーションの親ウィンドウが所有するモーダル ダイアログ ボックスが表示されます。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
Header
Wia.h
IDL
Wia.idl
ライブラリ
Wiaguid.lib