Share via

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

LONG ，即 pbData 引用的数据的大小。

pbData [in]

类型： BYTE*

指向 BandedDataCallback 接收的数据缓冲区的指针。

pbstrDescription [out]

类型： BSTR*

接收数据传输过程中遇到的状态或错误的说明的 BSTR。 此参数不能为 NULL。 调用方必须使用 SysFreeString 释放字符串，实现者必须使用 SysAllocString 分配字符串。

返回值

类型： HRESULT

返回以下值之一。

返回代码 说明
S_OK
 pbstrDescription 包含有效的 BSTR 指针。
S_FALSE
 hrStatus 未知，并且没有可用的说明。

 

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 [仅限桌面应用]
标头
Wia.h
IDL
Wia.idl
库
Wiaguid.lib