CM_WaitNoPendingInstallEvents (cfgmgr32.h)

  • Artikel

Fungsi CMP_WaitNoPendingInstallEvents (CM_WaitNoPendingInstallEvents) menunggu sampai tidak ada aktivitas penginstalan perangkat yang tertunda untuk dilakukan manajer PnP.

Sintaks

DWORD CM_WaitNoPendingInstallEvents(
  [in] DWORD dwTimeout
);

Parameter

[in] dwTimeout

Menentukan interval waktu habis, dalam milidetik.

  • Jika dwTimeout diatur ke nol, fungsi akan menguji apakah ada peristiwa penginstalan yang tertunda dan segera kembali.
  • Jika dwTimeout diatur ke INFINITE (ditentukan dalam Winbase.h), interval waktu habis fungsi tidak pernah berlalu.
  • Untuk semua nilai dwTimeout lainnya, fungsi kembali ketika interval yang ditentukan berlalu, bahkan jika masih ada peristiwa penginstalan yang tertunda.

Mengembalikan nilai

Fungsi mengembalikan salah satu nilai berikut (ditentukan dalam Winbase.h):

Menampilkan kode Deskripsi
WAIT_OBJECT_0
 Tidak ada aktivitas penginstalan yang tertunda.
WAIT_TIMEOUT
 Interval waktu habis berlalu, dan aktivitas penginstalan masih tertunda.
WAIT_FAILED
 Fungsi gagal. Panggil GetLastError untuk informasi kesalahan tambahan.

Keterangan

Fungsi menunggu objek peristiwa internal, yang ditetapkan manajer PnP ketika menentukan bahwa tidak ada aktivitas penginstalan yang tertunda.

Jika nilai waktu habis bukan nol ditentukan, maka CMP_WaitNoPendingInstallEvents akan mengembalikan baik ketika tidak ada peristiwa penginstalan yang tertunda atau ketika periode waktu habis telah kedaluwarsa, mana yang lebih dulu.

Peristiwa penginstalan baru dapat terjadi kapan saja. Fungsi ini hanya menunjukkan bahwa tidak ada aktivitas penginstalan yang tertunda saat dipanggil.

Fungsi ini biasanya digunakan oleh aplikasi penginstalan perangkat. Untuk informasi selengkapnya, lihat Menulis Aplikasi Penginstalan Perangkat.

Jangan panggil fungsi ini saat memproses peristiwa apa pun di dalam fungsi panggilan balik yang dimulai sistem yang diharapkan akan kembali dalam waktu singkat. Ini termasuk startup layanan (misalnya dalam fungsi panggilan balik ServiceMain ) atau saat memproses kontrol apa pun di handler layanan (misalnya, fungsi panggilan balik Handler ), atau dari komponen penginstalan seperti penginstal kelas atau penginstal bersama.

Untuk Windows XP (tanpa paket layanan terinstal), fungsi ini harus dipanggil dari nol sesi, dengan hak istimewa administrator. Untuk Windows XP dengan Paket Layanan 1 (SP1) dan versi Windows yang lebih baru, fungsi dapat dipanggil dari sesi apa pun, dan hak istimewa administrator tidak diperlukan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows XP dan versi Windows yang lebih baru.
Target Platform Desktop
Header cfgmgr32.h (termasuk Cfgmgr32.h)
Pustaka Cfgmgr32.lib
DLL Cfgmgr32.dll

Lihat juga

CM_WaitNoPendingInstallEvents

Cara Aplikasi Penginstalan Perangkat memeriksa penginstalan perangkat yang sedang berlangsung