énumération PRJ_NOTIFY_TYPES (projectedfslib.h)

Types de notifications décrivant une modification apportée au fichier ou au dossier.

Syntax

typedef enum PRJ_NOTIFY_TYPES {
  PRJ_NOTIFY_NONE = 0x00000000,
  PRJ_NOTIFY_SUPPRESS_NOTIFICATIONS = 0x00000001,
  PRJ_NOTIFY_FILE_OPENED = 0x00000002,
  PRJ_NOTIFY_NEW_FILE_CREATED = 0x00000004,
  PRJ_NOTIFY_FILE_OVERWRITTEN = 0x00000008,
  PRJ_NOTIFY_PRE_DELETE = 0x00000010,
  PRJ_NOTIFY_PRE_RENAME = 0x00000020,
  PRJ_NOTIFY_PRE_SET_HARDLINK = 0x00000040,
  PRJ_NOTIFY_FILE_RENAMED = 0x00000080,
  PRJ_NOTIFY_HARDLINK_CREATED = 0x00000100,
  PRJ_NOTIFY_FILE_HANDLE_CLOSED_NO_MODIFICATION = 0x00000200,
  PRJ_NOTIFY_FILE_HANDLE_CLOSED_FILE_MODIFIED = 0x00000400,
  PRJ_NOTIFY_FILE_HANDLE_CLOSED_FILE_DELETED = 0x00000800,
  PRJ_NOTIFY_FILE_PRE_CONVERT_TO_FULL = 0x00001000,
  PRJ_NOTIFY_USE_EXISTING_MASK = 0xFFFFFFFF
} ;

Constantes

Remarques

ProjFS peut envoyer des notifications d’activité du système de fichiers à un fournisseur. Lorsque le fournisseur démarre une virtualisation instance il spécifie les notifications qu’il souhaite recevoir. Il peut également spécifier un nouvel ensemble de notifications pour un fichier lors de sa création ou de son renommage. Le fournisseur doit inscrire une routine de rappel de notification PRJ_NOTIFICATION_CB dans le paramètre rappels de PrjStartVirtualizing pour recevoir des notifications.

ProjFS envoie des notifications pour les fichiers et les répertoires au sein d’une racine de virtualisation active. Autrement dit, ProjFS envoie des notifications pour la racine de virtualisation et ses descendants. Les liens symboliques et les jonctions au sein de la racine de virtualisation ne sont pas parcourus lors de la détermination de ce qui constitue un descendant de la racine de virtualisation.

ProjFS envoie des notifications uniquement pour le flux de données principal d’un fichier. ProjFS n’envoie pas de notifications pour les opérations sur d’autres flux de données.

ProjFS n’envoie pas de notifications pour un instance de virtualisation inactif. Un instance de virtualisation est inactif si l’une des conditions suivantes est vraie :

• Le fournisseur n’a pas encore commencé en appelant PrjStartVirtualizing.
• Le fournisseur a arrêté le instance en appelant PrjStopVirtualizing.
• Le processus du fournisseur a quitté

Le fournisseur peut spécifier les notifications qu’il souhaite recevoir lors du démarrage d’un instance de virtualisation ou en réponse à une notification qui permet de définir un nouveau masque de notification.

Le fournisseur spécifie un ensemble par défaut de notifications qu’il souhaite que ProjFS envoie pour le instance de virtualisation lorsqu’il démarre le instance. Cet ensemble de notifications est fourni dans le membre NotificationMappings du paramètre options de PrjStartVirtualizing, qui peut spécifier différents masques de notification pour différentes sous-arborescences du instance de virtualisation.

Le fournisseur peut choisir de fournir un autre masque de notification en réponse à une notification d’ouverture de fichier, de création, de remplacement/remplacement ou de renommage. ProjFS continuera à envoyer ces notifications pour le fichier donné jusqu’à ce que tous les handles du fichier soient fermés. Après cela, le jeu de notifications par défaut est rétabli. Naturellement, si le jeu de notifications par défaut ne spécifie pas que ProjFS doit notifier l’ouverture, la création, etc., le fournisseur n’aura pas la possibilité de spécifier un masque différent pour ces opérations.

Configuration requise