Fungsi SetupDefaultQueueCallbackA (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 Penginstal Windows untuk mengembangkan penginstal aplikasi. PenyetelanAPI terus digunakan untuk menginstal pengandar perangkat.]

Fungsi SetupDefaultQueueCallback adalah rutinitas panggilan balik antrean default yang disertakan dengan API Penyiapan. Anda dapat menggunakannya untuk memproses pemberitahuan yang dikirim oleh fungsi SetupCommitFileQueue .

Sintaksis

WINSETUPAPI UINT SetupDefaultQueueCallbackA(
  [in] PVOID    Context,
  [in] UINT     Notification,
  [in] UINT_PTR Param1,
  [in] UINT_PTR Param2
);

Parameter

[in] Context

Penunjuk ke konteks yang diinisialisasi oleh fungsi SetupInitDefaultQueueCallback atau SetupInitDefaultQueueCallbackEx.

[in] Notification

Pemberitahuan tindakan antrean. Parameter ini bisa menjadi salah satu nilai yang diperlihatkan dalam tabel berikut.

Nilai	Arti
SPFILENOTIFY_STARTQUEUE	Mulai mengantre operasi file.
SPFILENOTIFY_ENDQUEUE	Selesai mengantre operasi file.
SPFILENOTIFY_STARTSUBQUEUE	Memulai salinan, mengganti nama, atau menghapus sub-antrean.
SPFILENOTIFY_ENDSUBQUEUE	Menyelesaikan salinan, mengganti nama, atau menghapus sub-antrean.
SPFILENOTIFY_STARTRENAME	Memulai operasi ganti nama.
SPFILENOTIFY_ENDRENAME	Menyelesaikan operasi ganti nama.
SPFILENOTIFY_RENAMEERROR	Terjadi kesalahan saat mengganti nama file.
SPFILENOTIFY_STARTDELETE	Memulai operasi penghapusan.
SPFILENOTIFY_ENDDELETE	Menyelesaikan operasi penghapusan.
SPFILENOTIFY_DELETEERROR	Terjadi kesalahan saat menghapus file.
SPFILENOTIFY_STARTCOPY	Memulai operasi penyalinan.
SPFILENOTIFY_ENDCOPY	Menyelesaikan operasi penyalinan.
SPFILENOTIFY_COPYERROR	Terjadi kesalahan saat menyalin file.
SPFILENOTIFY_NEEDMEDIA	Media baru diperlukan.
SPFILENOTIFY_LANGMISMATCH	File target yang ada berada dalam bahasa yang berbeda dari sumbernya.
SPFILENOTIFY_TARGETEXISTS	File target ada.
SPFILENOTIFY_TARGETNEWER	File target yang ada lebih baru dari sumber.

[in] Param1

Informasi pesan tambahan. Konten parameter ini tergantung pada nilai parameter Pemberitahuan .

[in] Param2

Informasi pesan tambahan. Konten parameter ini tergantung pada nilai parameter Pemberitahuan .

Mengembalikan nilai

Mengembalikan bilangan bulat yang tidak ditandatangani ke SetupCommitFileQueue yang bisa menjadi salah satu nilai yang diperlihatkan dalam tabel berikut.

Mengembalikan kode	Deskripsi
FILEOP_ABORT	Membatalkan operasi.
FILEOP_DOIT	Melakukan operasi file.
FILEOP_SKIP	Lewati operasi.
FILEOP_RETRY	Mencoba kembali operasi.
FILEOP_NEWPATH	Mendapatkan jalur baru untuk operasi.

 

Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Fungsi SetupDefaultQueueCallback biasanya hanya dipanggil secara eksplisit oleh rutinitas panggilan balik antrean kustom. Panggilan balik kustom menangani subset pemberitahuan penerapan antrean dan memanggil fungsi SetupDefaultQueueCallback untuk menangani pemberitahuan lainnya.

Untuk informasi selengkapnya, lihat Pemberitahuan Antrean .

Nota

Header setupapi.h mendefinisikan SetupDefaultQueueCallback sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Lihat juga

Functions

Gambaran Umum

SetupCommitFileQueue