SFVM_GETNOTIFY message

Article
06/13/2023

Notification envoyée à l’objet de rappel d’affichage pour spécifier les emplacements et les événements qui doivent être inscrits pour les événements de notification de modification. Une fois qu’ils sont inscrits, lorsqu’une modification se produit sur ces emplacements ou événements, l’objet de rappel d’affichage est notifié. Ces événements sont envoyés au rappel d’affichage via SFVM_FSNOTIFY et sont ensuite gérés par la vue.

SFVM_GETNOTIFY 

    wParam = (WPARAM)(LPITEMIDLIST*) pidl;

    lParam = (LPARAM)(LONG*) lEvents;

Paramètres

pidl [out]

Pointeur vers une IDList absolue d’un élément pour lequel la vue doit s’inscrire pour être informée des modifications. En règle générale, cela est identique à l’IDList de l’emplacement en cours d’affichage, mais il peut s’agir d’un autre emplacement.

Important

La durée de vie de cette valeur appartient à l’objet de rappel d’affichage. Il incombe à l’objet de rappel d’affichage de créer, puis de libérer cette valeur quand elle n’est plus nécessaire. Pour cela, l’objet de rappel d’affichage doit stocker cette valeur. En règle générale, la valeur peut être stockée dans le membre _pidlMonitor de l’objet de rappel d’affichage. Les règles de propriété de la valeur retournée par le biais de pidl ne sont pas standard et nécessitent une attention particulière. L’objet de rappel de vue doit posséder cette valeur et s’assurer qu’il n’est pas libéré tant que l’objet de rappel d’affichage lui-même n’est pas détruit.

lEvents [out]

Valeur qui contient une ou plusieurs valeurs SHCNE. Pour obtenir la liste des valeurs possibles, consultez SHChangeNotify . L’objet de rappel d’affichage s’inscrit pour recevoir un message SFVM_FSNOTIFY lorsque l’un des événements associés se produit.

Valeur retournée

Ignoré, mais doit retourner S_OK.

Notes

Si ce message de rappel ne retourne pas une valeur différente de zéro pour l’IDList ou le masque des événements, la vue ne s’inscrit pas pour les notifications de modification.

Exemples

L’exemple suivant montre un exemple d’implémentation du code de gestionnaire de la fonction de rappel d’affichage pour 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;

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Shlobj.h

Voir aussi

SFVM_QUERYFSNOTIFY
IShellFolderViewCB::MessageSFVCB

Partager via