次の方法で共有

IWiaErrorHandler::GetStatusDescription メソッド

  • [アーティクル]

状態コードを記述する文字列を返します。

構文

HRESULT GetStatusDescription(
  [in]  IUnknown *punkItem,
  [in]  HRESULT  hrStatus,
  [in]  LONG     cbResLength,
  [in]  BYTE     *pbData,
  [out] BSTR     *pbstrDescription
);

パラメーター

punkItem [in]

種類: IUnknown*

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

hrStatus [in]

型: HRESULT

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

cbResLength [in]

型: LONG

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

pbData [in]

型: BYTE*

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

pbstrDescription [out]

種類: BSTR*

データ転送中に発生した状態またはエラーの説明を受け取る BSTR。 このパラメーターを NULL にすることはできません。 呼び出し元は SysFreeString を使用して文字列を解放する必要があり、実装者は SysAllocString を使用して文字列を割り当てる必要があります。

戻り値

型: HRESULT

次のいずれかの値を返します。

リターン コード 説明
S_OK
 pbstrDescription には、有効な BSTR ポインターが含まれています。
S_FALSE
 hrStatus は不明であり、使用できる説明はありません。

 

要件

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