SFVM _ GETNOTIFY-Nachricht

Benachrichtigung, die an das Ansichtsrückrufobjekt gesendet wird, um die Speicherorte und Ereignisse anzugeben, die für Änderungsbenachrichtigungsereignisse registriert werden sollen. Sobald sie registriert sind, wird das Ansichtsrückrufobjekt benachrichtigt, wenn eine Änderung an diesen Speicherorten oder Ereignissen in 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 Sicht registriert werden soll, um über Änderungen benachrichtigt zu werden. In der Regel ist dies identisch mit der IDList des angezeigten Standorts, aber es kann sich um einen anderen Speicherort handelt.

Wichtig

Die Lebensdauer dieses Werts ist im Besitz des Ansichtsrückrufobjekts. 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. In der Regel kann der Wert im _ PidlMonitor-Member des Ansichtsrückrufobjekts gespeichert werden. Die Besitzregeln für den von pidl zurückgegebenen Wert sind nicht dem Standard und erfordern besondere Sorgfalt. Das Ansichtsrückrufobjekt muss diesen Wert besitzen und sicherstellen, dass er erst wieder frei 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ückrufmeldung keinen Wert ungleich 0 (null) für idList oder die Ereignismaske zurück gibt, wird die Sicht nicht für Änderungsbenachrichtigungen registriert.

Beispiele

Das folgende Beispiel zeigt eine Beispielimplementierung des Handlercodes der Rü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;

Requirements (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

Weitere Informationen

SFVM _ QUERYFSNOTIFY

IShellFolderViewCB::MessageSFVCB