SFVM_GETNOTIFY Nachricht

Artikel
06/13/2023

Benachrichtigung, die an das Ansichtsrückrufobjekt gesendet wird, um die Speicherorte und Ereignisse anzugeben, die für Änderungsbenachrichtigungsereignisse registriert werden sollen. Sobald sie registriert wurden, wird das Ansichtsrückrufobjekt benachrichtigt, wenn eine Änderung an diesen Speicherorten oder Ereignissen auftritt. Diese Ereignisse werden über SFVM_FSNOTIFY an den Ansichtsrückruf gesendet und dann von der Ansicht behandelt.

SFVM_GETNOTIFY 

    wParam = (WPARAM)(LPITEMIDLIST*) pidl;

    lParam = (LPARAM)(LONG*) lEvents;

Parameter

pidl [out]

Ein Zeiger auf eine absolute IDList eines Elements, für das die Ansicht registriert werden soll, um über Änderungen benachrichtigt zu werden. In der Regel entspricht dies der IDList des angezeigten Speicherorts, kann jedoch ein anderer Speicherort sein.

Wichtig

Die Lebensdauer dieses Werts gehört dem View-Rückrufobjekt. Es liegt in der Verantwortung des Ansichtsrückrufobjekts, diesen Wert zu erstellen und dann frei zu geben, wenn er nicht mehr benötigt wird. Dies erfordert, dass das Ansichtsrückrufobjekt diesen Wert speichert. Normalerweise kann der Wert im _pidlMonitor Member des Ansichtsrückrufobjekts gespeichert werden. Die Besitzregeln für den wert, der über pidl zurückgegeben wird, sind nicht standardgemäß und erfordern besondere Sorgfalt. Das Ansichtsrückrufobjekt muss diesen Wert besitzen und sicherstellen, dass er erst freigegeben wird, wenn das Ansichtsrückrufobjekt selbst zerstört wird.

lEvents [out]

Ein -Wert, der einen oder mehrere SHCNE-Werte enthält. Eine Liste der möglichen Werte finden Sie unter SHChangeNotify . Das Ansichtsrückrufobjekt wird registriert, um eine SFVM_FSNOTIFY Nachricht zu empfangen, wenn eines der zugeordneten Ereignisse auftritt.

Rückgabewert

Ignoriert, sollte aber S_OK zurückgeben.

Bemerkungen

Wenn diese Rückrufnachricht keinen Wert ungleich null für die IDList oder die Ereignismaske zurückgibt, wird die Ansicht nicht für Änderungsbenachrichtigungen registriert.

Beispiele

Das folgende Beispiel zeigt eine Beispielimplementierung des Handlercodes der Ansichtsrückruffunktion für 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;

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Shlobj.h

Siehe auch

SFVM_QUERYFSNOTIFY
IShellFolderViewCB::MessageSFVCB

Freigeben über