SFVM_GETNOTIFY pesan

Artikel
06/13/2023

Pemberitahuan yang dikirim ke objek panggilan balik tampilan untuk menentukan lokasi dan peristiwa yang harus didaftarkan untuk peristiwa pemberitahuan perubahan. Setelah terdaftar, ketika perubahan terjadi di lokasi atau peristiwa ini, objek panggilan balik tampilan akan diberi tahu. Peristiwa ini dikirim ke panggilan balik tampilan melalui SFVM_FSNOTIFY dan kemudian ditangani oleh tampilan.

SFVM_GETNOTIFY 

    wParam = (WPARAM)(LPITEMIDLIST*) pidl;

    lParam = (LPARAM)(LONG*) lEvents;

Parameter

pidl [out]

Penunjuk ke IDList absolut item yang tampilannya harus didaftarkan untuk diberi tahu tentang perubahan. Biasanya, ini sama dengan IDList lokasi yang dilihat, tetapi bisa menjadi lokasi lain.

Penting

Masa pakai nilai ini dimiliki oleh objek panggilan balik tampilan. Adalah tanggung jawab objek panggilan balik tampilan untuk membuat dan kemudian membebaskan nilai ini ketika tidak lagi diperlukan. Ini mengharuskan objek panggilan balik tampilan menyimpan nilai ini. Biasanya, nilai dapat disimpan di _pidlMonitor anggota objek panggilan balik tampilan. Aturan kepemilikan untuk nilai yang dikembalikan melalui pidl tidak standar dan memerlukan perawatan khusus. Objek panggilan balik tampilan harus memiliki nilai ini dan memastikan bahwa itu tidak dikosongkan sampai objek panggilan balik tampilan itu sendiri dihancurkan.

lEvents [out]

Nilai yang berisi satu atau beberapa nilai SHCNE. Lihat SHChangeNotify untuk daftar nilai yang mungkin. Objek panggilan balik tampilan akan mendaftar untuk menerima pesan SFVM_FSNOTIFY ketika salah satu peristiwa terkait terjadi.

Menampilkan nilai

Diabaikan, tetapi harus mengembalikan S_OK.

Keterangan

Jika pesan panggilan balik ini tidak mengembalikan nilai bukan nol untuk IDList atau mask peristiwa, tampilan tidak akan mendaftar untuk pemberitahuan perubahan.

Contoh

Contoh berikut menunjukkan contoh implementasi kode handler fungsi panggilan balik tampilan untuk SFVM_GETNOTIFY.

case SFVM_GETNOTIFY:
  *((LPITEMIDLIST*)wParam) = _pidl;    // Pass a reference whose lifetime this 
                                       // class is responsible for.
                                      
  *((LONG*)lParam) = SHCNE_DISKEVENTS; // A combination of all of the 
                                       // disk event identifiers.
                                       
   return S_OK;

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Shlobj.h

Lihat juga

SFVM_QUERYFSNOTIFY
IShellFolderViewCB::MessageSFVCB

Bagikan melalui