Bagikan melalui

pesan SPFILENOTIFY_STARTREGISTRATION

  • Artikel

Saat menggunakan direktif REGISTERDlls INF untuk mendaftarkan dll sendiri, pemanggil SetupInstallFromInfSection mungkin menerima pemberitahuan pada setiap file karena terdaftar atau tidak terdaftar. Untuk mengirim pemberitahuan SPFILENOTIFY_STARTREGISTRATION ke rutinitas panggilan balik sekali sebelum mendaftarkan file, sertakan SPINST_REGISTERCALLBACKAWARE plus SPINST_REGSVR dalam parameter BenderaSetupInstallFromInfSection. Untuk mengirim pemberitahuan pembatasan pendaftaran, sertakan SPINST_REGISTERCALLBACKAWARE plus SPINST_UNREGSVR dalam parameter Bendera .

Rutinitas panggilan balik yang ditentukan oleh parameter MsgHandler dari SetupInstallFromInfSection harus berupa jenis PSP_FILE_CALLBACK. Atur parameter Konteks ke Konteks yang sama yang ditentukan dalam SetupInstallFromInfSection. Atur parameter Pemberitahuan ke SPFILENOTIFY_STARTREGISTRATION.

SPFILENOTIFY_STARTREGISTRATION
  Param1 = (UINT_PTR) pointer to file information;
  Param2 = (UINT_PTR) file registration or unregistration;

Parameter

Param1

Penunjuk ke struktur SP_REGISTER_CONTROL_STATUS yang berisi informasi tentang file yang didaftarkan atau tidak terdaftar. Anggota cbsize harus diatur ke ukuran struktur. Anggota FileName harus diatur ke jalur file yang sepenuhnya memenuhi syarat yang sedang didaftarkan. Win32Error tidak digunakan dan harus diatur ke NO_ERROR. FailureCode tidak digunakan dan harus diatur ke SPREG_SUCCESS.

Param2

Jika file sedang didaftarkan, Param2 harus diatur ke pointer ke nilai bukan nol. Jika file tidak terdaftar, Param2 harus diatur ke pointer ke nol.

Menampilkan nilai

Setelah menerima pemberitahuan, fungsi panggilan balik dapat mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
FILEOP_ABORT
 Jangan mendaftarkan atau membatalkan pendaftaran file dan berhenti memproses bagian INF.
FILEOP_DOIT
 Daftarkan atau batalkan pendaftaran file dan lanjutkan pemrosesan bagian INF.
FILE_SKIP
 Lewati pendaftaran atau batalkan pendaftaran file tetapi lanjutkan pemrosesan bagian INF

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

SetupInstallFromInfSection

SPFILENOTIFY_ENDREGISTRATION