Fungsi SetupInitDefaultQueueCallbackEx (setupapi.h)

[Fungsi ini tersedia untuk digunakan dalam sistem operasi yang ditunjukkan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. SetupAPI tidak boleh lagi digunakan untuk menginstal aplikasi. Sebagai gantinya, gunakan Pemasang Windows untuk mengembangkan penginstal aplikasi. PenyetelanAPI terus digunakan untuk menginstal pengandar perangkat.]

Fungsi SetupInitDefaultQueueCallbackEx menginisialisasi konteks yang digunakan oleh rutinitas panggilan balik antrean default yang disertakan dengan API Penyiapan dengan cara yang sama seperti SetupInitDefaultQueueCallback, kecuali bahwa jendela tambahan disediakan untuk fungsi panggilan balik untuk menerima pesan kemajuan.

Sintaks

WINSETUPAPI PVOID SetupInitDefaultQueueCallbackEx(
  [in] HWND  OwnerWindow,
  [in] HWND  AlternateProgressWindow,
  [in] UINT  ProgressMessage,
  [in] DWORD Reserved1,
  [in] PVOID Reserved2
);

Parameter

[in] OwnerWindow

Tangani ke jendela untuk digunakan sebagai induk kotak dialog apa pun yang dihasilkan oleh rutinitas panggilan balik default.

[in] AlternateProgressWindow

Menangani ke jendela yang menerima pesan kemajuan. Untuk mencegah pesan kemajuan ditampilkan, Anda dapat menentukan parameter ini untuk INVALID_HANDLE_VALUE.

[in] ProgressMessage

Pesan yang dikirim ke AlternateProgressWindow saat antrean salin dimulai, dan setiap kali file disalin.

[in] Reserved1

Parameter pesan pertama yang dikirim ke AlternateProgressWindow dengan rutinitas panggilan balik default.

[in] Reserved2

Parameter pesan kedua yang dikirim ke AlternateProgressWindow oleh rutinitas panggilan balik default.

Mengembalikan nilai

SetupInitDefaultQueueCallbackEx mengembalikan pointer ke konteks yang digunakan oleh rutinitas panggilan balik antrean default. Fungsi ini hanya dapat gagal jika memori tidak memadai. Jika fungsi ini gagal, fungsi ini mengembalikan NULL dan tidak mengatur kode kesalahan terakhir untuk utas.

Keterangan

Ketika antrean mulai menerapkan subantrean salin, rutinitas panggilan balik antrean default mengirim pesan ke jendela yang ditentukan dalam AlternateProgressWindow. Reserved1 memiliki nilai 0, dan Reserved2 berisi pointer ke jumlah operasi penyalinan file yang diantrekan.

Untuk setiap operasi penyalinan file selesai, rutinitas panggilan balik antrean default mengirim pesan ke AlternateProgressWindow, yang dapat digunakan untuk 'mencentang' bilah kemajuan. Reserved1 memiliki nilai 1, dan Reserved2 adalah nol.

SetupInitDefaultQueueCallbackEx dapat digunakan untuk mendapatkan perilaku default untuk permintaan disk, penanganan kesalahan, dan sebagainya, dan juga menyediakan pengukur yang disematkan di halaman wizard atau kotak dialog khusus lainnya.

Terlepas dari apakah Anda menginisialisasi konteks yang digunakan oleh rutinitas panggilan balik antrean default dengan SetupInitDefaultQueueCallback atau SetupInitDefaultQueueCallbackEx, setelah operasi antrean selesai diproses, panggil SetupTermDefaultQueueCallback untuk merilis sumber daya yang dialokasikan dalam menginisialisasi struktur konteks. Untuk informasi selengkapnya, lihat Menginisialisasi dan Mengakhiri Konteks Panggilan Balik.

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	setupapi.h
Pustaka	Setupapi.lib
DLL	Setupapi.dll
Set API	ext-ms-win-setupapi-classinstallers-l1-1-2 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Lihat juga

Fungsi

Gambaran Umum

SetupInitDefaultQueueCallback