messaggio di SFVM_GETNOTIFY

Articolo
06/13/2023

Notifica inviata all'oggetto callback di visualizzazione per specificare i percorsi e gli eventi che devono essere registrati per gli eventi di notifica delle modifiche. Dopo la registrazione, quando si verifica una modifica in su questi percorsi o eventi, l'oggetto di callback di visualizzazione riceve una notifica. Questi eventi vengono inviati al callback della visualizzazione tramite SFVM_FSNOTIFY e quindi gestiti dalla visualizzazione.

SFVM_GETNOTIFY 

    wParam = (WPARAM)(LPITEMIDLIST*) pidl;

    lParam = (LPARAM)(LONG*) lEvents;

Parametri

pidl [out]

Puntatore a un IDList assoluto di un elemento per il quale la visualizzazione deve essere registrata per ricevere una notifica delle modifiche. In genere, si tratta dello stesso IDList della posizione visualizzata, ma può essere un'altra posizione.

Importante

La durata di questo valore è di proprietà dell'oggetto callback della visualizzazione. È responsabilità dell'oggetto callback di visualizzazione creare e quindi liberare questo valore quando non è più necessario. Ciò richiede che l'oggetto callback della visualizzazione archivii questo valore. In genere, il valore può essere archiviato nel membro _pidlMonitor dell'oggetto callback di visualizzazione. Le regole di proprietà per il valore restituito tramite pidl non sono standard e richiedono particolare attenzione. L'oggetto callback della visualizzazione deve possedere questo valore e assicurarsi che non venga liberato finché l'oggetto callback della visualizzazione non viene eliminato definitivamente.

lEvents [out]

Valore contenente uno o più valori SHCNE. Per un elenco dei valori possibili, vedere SHChangeNotify . L'oggetto callback di visualizzazione verrà registrato per ricevere un messaggio SFVM_FSNOTIFY quando si verifica uno degli eventi associati.

Valore restituito

Ignorato, ma deve restituire S_OK.

Commenti

Se questo messaggio di callback non restituisce un valore diverso da zero per IDList o la maschera eventi, la visualizzazione non verrà registrata per le notifiche di modifica.

Esempio

Nell'esempio seguente viene illustrata un'implementazione di esempio del codice del gestore della funzione di callback di visualizzazione per 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;

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Shlobj.h

Vedi anche

SFVM_QUERYFSNOTIFY
IShellFolderViewCB::MessageSFVCB

Condividi tramite