Bagikan melalui


SPFILENOTIFY_NEEDNEWCABINET pesan

Pemberitahuan SPFILENOTIFY_NEEDNEWCABINET dikirim oleh SetupIterateCabinet untuk menunjukkan bahwa file saat ini berlanjut di kabinet lain. Rutinitas panggilan balik Anda kemudian dapat memanggil SetupPromptForDisk, atau membuat kotak dialognya sendiri untuk meminta pengguna menyisipkan disk berikutnya.

SPFILENOTIFY_NEEDNEWCABINET
  Param1 = (UINT) CabinetInfo;
  Param2 = (UINT) NewPath;
            

Parameter

Param1

Arahkan ke struktur CABINET_INFO yang berisi informasi tentang kabinet dan file yang akan diekstrak.

Param2

Jika panggilan balik mengembalikan NO_ERROR, parameter ini adalah penunjuk ke string yang dihentikan null. Jika string tidak kosong, string menentukan jalur baru ke kabinet.

Nilai kembali

Rutinitas Anda harus mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
NO_ERROR
Tidak ada kesalahan yang ditemui, lanjutkan pemrosesan kabinet.
ERROR_XXXX
Terjadi kesalahan dari tipe yang ditentukan. Fungsi SetupIterateCabinet akan mengembalikan FALSE, dan kode kesalahan yang ditentukan akan dikembalikan oleh panggilan ke GetLastError.

Catatan

Tidak ada rutinitas panggilan balik kabinet default; dengan demikian, Anda harus menyediakan rutinitas panggilan balik untuk menangani pemberitahuan yang dikirim oleh SetupIterateCabinet.

Keterangan

Jika rutinitas panggilan balik mengembalikan NO_ERROR, SetupIterateCabinet memeriksa buffer yang ditunjukkan oleh Param2. Jika buffer tidak kosong, maka berisi jalur sumber baru. Jika buffer kosong, jalur sumber diasumsikan tidak berubah.

Fungsi panggilan balik Anda harus memastikan bahwa kabinet dapat diakses sebelum kembali, memanggil fungsi SetupPromptForDisk , jika media baru perlu dimasukkan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows XP [hanya aplikasi desktop]
Server minimum yang didukung
Windows Server 2003 [hanya aplikasi desktop]
Header
Setupapi.h

Lihat juga

Gambaran Umum

Pemberitahuan

CABINET_INFO

SetupIterateCabinet