次の方法で共有

IWiaErrorHandler::ReportStatus メソッド

  • [アーティクル]

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

構文

HRESULT ReportStatus(
  [in] HWND     hwndParent,
  [in] IUnknown *punkItem,
  [in] HRESULT  hrStatus,
  [in] LONG     cbResLength,
  [in] BYTE     *pbData
);

パラメーター

hwndParent [in]

型: HWND

メッセージ ウィンドウの親ウィンドウである HWND。

punkItem [in]

種類: IUnknown*

転送されるアイテムの IUnknown インターフェイスへのポインター。 このオブジェクトは、 IWiaItem2 と IWiaDataTransfer を最小限に抑えて実装します。

hrStatus [in]

型: HRESULT

BandedDataCallback によって受信された状態コードである HRESULT。

cbResLength [in]

型: LONG

pbData によって参照されるデータのサイズを示す LONG。

pbData [in]

型: BYTE*

BandedDataCallback によって受信されたデータ バッファーへのポインター。

戻り値

型: HRESULT

エラーを回復できない場合は hrStatus を返します。 それ以外の場合は、次のいずれかの値を返します。

リターン コード 説明
S_OK
 エラーを修正するための適切なアクションが実行され、転送を続行できます。
S_FALSE
 ユーザーに対するエラーまたはレポートの状態を処理するためのアクションは実行されませんでした。
E_ABORT
 ユーザーは、表示されたダイアログ ボックスに応答して転送を中止することを選択しました。

 

注釈

ドライバーが BandedDataCallback にIT_MSG_DEVICE_STATUS メッセージを送信すると、Windows イメージ取得 (WIA) 2.0 は IWiaErrorHandler::ReportStatus を呼び出します。 このメソッドは、メッセージを処理し、状態またはエラーに関する情報をユーザーに表示します。 エラーに関するメッセージの場合、 メソッドを使用すると、可能であれば、エラーから回復して転送を続行するか中止するかをユーザーが選択できます。

hrStatus が WIA_STATUS_TRANSFER_BEGIN に設定され、転送が開始されたことをハンドラーに通知します。 転送が完了すると、WIA_STATUS_TRANSFER_ENDに設定されます。

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

要件

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