IStillImageW::RegisterLaunchApplication method (sti.h)

  • Artikel

Metode IStillImage::RegisterLaunchApplication menambahkan aplikasi ke daftar aplikasi sadar model push monitor gambar diam.

Sintaks

HRESULT RegisterLaunchApplication(
  [in] LPWSTR pwszAppName,
  [in] LPWSTR pwszCommandLine
);

Parameter

[in] pwszAppName

Penunjuk yang disediakan penelepon ke string yang mewakili "nama pendek" aplikasi, yang akan ditampilkan oleh pemindai dan kamera Panel Kontrol lembar properti.

[in] pwszCommandLine

Penunjuk yang disediakan penelepon ke string yang mewakili baris perintah yang diperlukan untuk memulai aplikasi, termasuk jalur lengkap ke file yang dapat dieksekusi aplikasi. Jalur saat ini dapat diperoleh dengan memanggil GetModuleFileName (dijelaskan dalam dokumentasi Microsoft Windows SDK). Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Nilai kembali

Jika operasi berhasil, metode akan mengembalikan S_OK. Jika tidak, ia mengembalikan salah satu kode kesalahan berawalan STIERR yang ditentukan dalam stierr.h.

Keterangan

Aplikasi (atau alat penginstal aplikasi) harus memanggil IStillImage::RegisterLaunchApplication sehingga monitor peristiwa gambar diam akan mengetahui keberadaannya. Pengguna mengaitkan Still Image Device Events dengan aplikasi terdaftar dengan menggunakan antarmuka lembar properti Panel Kontrol. Setelah pengguna mengaitkan peristiwa perangkat dengan aplikasi, pemantau peristiwa akan memulai aplikasi saat peristiwa terjadi.

Metode ini menulis jalur beban aplikasi di registri. Oleh karena itu, metode harus dipanggil setiap kali aplikasi berjalan, karena pengguna mungkin telah memindahkan file dan GetModuleFileName selalu mengembalikan lokasi file saat ini.

Anda dapat menyertakan argumen perintah di baris perintah aplikasi. Saat memulai aplikasi terdaftar, pemantau peristiwa menambahkan dua argumen berikut ke baris perintah:

Argumen baris perintah Deskripsi
**/StiDevice:**InternalDeviceName InternalDeviceName adalah nama perangkat internal perangkat tempat aplikasi dimulai.
**/StiEvent:**EventGUID EventGUID adalah representasi string GUID untuk peristiwa perangkat yang telah terjadi.

Aplikasi dapat memperoleh nilai yang ditentukan untuk argumen ini dengan memanggil IStillImage::GetSTILaunchInformation.

Sebelum memanggil IStillImage::RegisterLaunchApplication, klien antarmuka IStillImage COM harus memanggil IStillImage::StiCreateInstance untuk mendapatkan penunjuk antarmuka IStillImage .

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header sti.h (termasuk Sti.h)