Metode IWiaErrorHandler::ReportStatus

Artikel
06/12/2023

Menangani status dan pesan kesalahan selama transfer data gambar dan menampilkannya kepada pengguna.

Sintaks

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

Parameter

hwndParent [in]

Jenis: HWND

HWND yang merupakan jendela induk untuk jendela pesan.

punkItem [in]

Jenis: IUnknown*

Penunjuk ke antarmuka IUnknown item yang sedang ditransfer. Objek ini secara minimal mengimplementasikan IWiaItem2 dan IWiaDataTransfer.

hrStatus [in]

Jenis: HRESULT

HRESULT yang merupakan kode status yang diterima oleh BandedDataCallback.

cbResLength [in]

Jenis: LONG

LONG yang merupakan ukuran data yang dimaksud oleh pbData.

pbData [in]

Jenis: BYTE*

Arahkan ke buffer data seperti yang diterima oleh BandedDataCallback.

Menampilkan nilai

Jenis: HRESULT

Mengembalikan hrStatus jika kesalahan tidak dapat dipulihkan. Jika tidak, ia mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Tindakan yang tepat diambil untuk memperbaiki kesalahan dan transfer dapat dilanjutkan.
S_FALSE	Tidak ada tindakan yang diambil untuk menangani kesalahan atau melaporkan status kepada pengguna.
E_ABORT	Pengguna memilih untuk membatalkan transfer sebagai respons terhadap kotak dialog yang ditampilkan.

Keterangan

Windows Image Acquisition (WIA) 2.0 memanggil IWiaErrorHandler::ReportStatus ketika driver mengirim pesan IT_MSG_DEVICE_STATUS ke BandedDataCallback. Metode ini menangani pesan dan menampilkan informasi kepada pengguna tentang status atau kesalahan. Jika pesan tentang kesalahan, metode ini memungkinkan pengguna memilih, jika memungkinkan, apakah akan mencoba memulihkan dari kesalahan dan melanjutkan transfer atau membatalkan.

hrStatus diatur ke WIA_STATUS_TRANSFER_BEGIN untuk memberi tahu handler bahwa transfer telah dimulai. Ini diatur ke WIA_STATUS_TRANSFER_END ketika transfer selesai.

Jika hrStatus SEVERITY_SUCCESS, pengguna harus diizinkan untuk membatalkan transfer.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	Wia.h
IDL	Wia.idl
Pustaka	Wiaguid.lib

Share via