Metode IWiaDevMgr2::GetImageDlg

Metode IWiaDevMgr2::GetImageDlg menampilkan satu atau beberapa kotak dialog yang memungkinkan pengguna memperoleh gambar dari perangkat Windows Image Acquisition (WIA) 2.0 dan menulis gambar ke file tertentu. Metode ini memperluas fungsionalitas IWiaDevMgr2::SelectDeviceDlg untuk merangkum akuisisi gambar dalam satu panggilan API.

Sintaks

HRESULT GetImageDlg(
  [in]      LONG      lFlags,
  [in]      BSTR      bstrDeviceID,
  [in]      HWND      hwndParent,
  [in]      BSTR      bstrFolderName,
  [in]      BSTR      bstrFilename,
  [in]      LONG      *plNumFiles,
  [in]      BSTR      **ppbstrFilePaths,
  [in, out] IWiaItem2 **ppItem
);

Parameter

lFlags [in]

Jenis: LONG

Menentukan perilaku kotak dialog. Dapat diatur ke nilai berikut:

Bendera	Makna
0	Perilaku default.
WIA_DEVICE_DIALOG_USE_COMMON_UI	Gunakan UI sistem alih-alih UI yang disediakan vendor. Jika UI sistem tidak tersedia, UI vendor akan digunakan. Jika tidak ada UI yang tersedia, fungsi akan mengembalikan E_NOTIMPL.

 

bstrDeviceID [in]

Jenis: BSTR

Menentukan pemindai yang akan digunakan.

hwndParent [in]

Jenis: HWND

Handel jendela yang memiliki kotak dialog Dapatkan Gambar .

bstrFolderName [in]

Jenis: BSTR

Menentukan nama folder tempat ito menyimpan file yang dipindai.

bstrFilename [in]

Jenis: BSTR

Menentukan nama file untuk menulis data gambar.

plNumFiles [in]

Jenis: LONG*

Penunjuk ke jumlah file yang akan dipindai.

ppbstrFilePaths [in]

Jenis: BSTR**

Alamat penunjuk ke array jalur untuk file yang dipindai. Inisialisasi penunjuk untuk menunjuk ke array ukuran nol (0) sebelum IWiaDevMgr2::GetImageDlg dipanggil. Lihat Keterangan.

ppItem [masuk, keluar]

Jenis: IWiaItem2**

Alamat pointer ke IWiaItem2 tempat gambar dipindai.

Menampilkan nilai

Jenis: HRESULT

IWiaDevMgr2::GetImageDlg mengembalikan S_OK jika data berhasil ditransfer, mengembalikan S_FALSE jika pengguna membatalkan kotak dialog, atau mengembalikan kesalahan COM standar.

Catatan

Parameter ppbstrFilePaths belum tentu kosong, jika fungsi mengembalikan S_FALSE. Jika pengguna membatalkan, halaman yang telah menyelesaikan pemindaian diproses dan dikembalikan dalam ppbstrFilePaths. Bahkan jika tidak digunakan, Anda harus membebaskan array. Lihat Keterangan.

 

Keterangan

Jika aplikasi melewati NULL untuk nilai parameter bstrDeviceID , IWiaDevMgr2::GetImageDlg menampilkan kotak dialog Pilih Perangkat sehingga pengguna dapat memilih perangkat input WIA 2.0.

Gunakan item menu bernama Dari pemindai pada menu File sehingga pilihan perangkat dan gambar tersedia di aplikasi Anda.

Panggil SysFreeString pada setiap BSTR dalam array yang dituju oleh ppbstrFilePaths[i], dan panggil CoTaskMemFree pada array itu sendiri untuk membebaskan memori terkait. Jika S_FALSE dikembalikan, periksa untuk melihat apakah nilai yang dituju plNumFiles bukan nol. Jika nilainya bukan nol, bebaskan sumber daya ppbstrFilePaths[i] dalam aplikasi, karena pengguna mungkin membatalkan setelah memindai satu atau beberapa halaman. Inisialisasi plNumFiles ke nol sebelum Anda memanggil IWiaDevMgr2::GetImageDlg. Jika plNumFiles tidak diinisialisasi ke nol dan kegagalan dalam infrastruktur COM menyebabkan fungsi kembali S_FALSE sebelum IWiaDevMgr2::GetImageDlg dipanggil, maka plNumFiles akan memiliki nilai sampah yang menyesatkan.

Kotak dialog harus memiliki hak yang memadai untuk bstrFolderName sehingga dapat menyimpan file dengan nama file yang unik. Lindungi folder dengan daftar kontrol akses (ACL) karena berisi data pengguna.

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