PRJ_CALLBACK_DATA structure (projectedfslib.h)

Définit les informations standard transmises à un fournisseur pour chaque rappel d’opération.

Syntaxe

typedef struct PRJ_CALLBACK_DATA {
  UINT32                               Size;
  PRJ_CALLBACK_DATA_FLAGS              Flags;
  PRJ_NAMESPACE_VIRTUALIZATION_CONTEXT NamespaceVirtualizationContext;
  INT32                                CommandId;
  GUID                                 FileId;
  GUID                                 DataStreamId;
  PCWSTR                               FilePathName;
  PRJ_PLACEHOLDER_VERSION_INFO         *VersionInfo;
  UINT32                               TriggeringProcessId;
  PCWSTR                               TriggeringProcessImageFileName;
  void                                 *InstanceContext;
} PRJ_CALLBACK_DATA;

Membres

Size

Taille en octets de cette structure. Le fournisseur ne doit pas tenter d’accéder à un champ de cette structure situé au-delà de cette valeur.

Flags

Indicateurs spécifiques au rappel.

NamespaceVirtualizationContext

Handle opaque à l’instance de virtualisation qui envoie le rappel.

CommandId

Valeur qui identifie de manière unique un appel particulier d’un rappel. Le fournisseur utilise cette valeur :

• Dans les appels à PrjCompleteCommand pour signaler l’achèvement d’un rappel à partir duquel il a précédemment retourné HRESULT_FROM_WIN32(ERROR_IO_PENDING).
• Lorsque ProjFS envoie un rappel PRJ_CANCEL_COMMAND_CB . Le commandId dans l’appel PRJ_CANCEL_COMMAND_CB identifie un appel antérieur d’un rappel que le fournisseur doit annuler.

FileId

Valeur qui identifie de manière unique le handle de fichier pour le rappel.

DataStreamId

Valeur qui identifie de manière unique un flux de données ouvert pour le rappel.

FilePathName

Chemin d’accès au fichier cible. Il s’agit d’une chaîne de caractères Unicode terminée par un caractère Null. Ce chemin est toujours spécifié par rapport à la racine de virtualisation.

VersionInfo

Informations de version si la cible du rappel est un espace réservé ou un fichier partiel.

TriggeringProcessId

Identificateur de processus pour le processus qui a déclenché ce rappel. Si ces informations ne sont pas disponibles, il s’agit de 0. Les rappels qui fournissent ces informations incluent : PRJ_GET_PLACEHOLDER_INFO_CB, PRJ_GET_FILE_DATA_CB et PRJ_NOTIFICATION_CB.

TriggeringProcessImageFileName

Chaîne Unicode terminée par null spécifiant le nom de fichier image correspondant à TriggeringProcessId. Si TriggeringProcessId a la valeur 0, cela sera NULL.

InstanceContext

Pointeur vers les informations de contexte définies par le fournisseur. Le fournisseur transmet ce contexte dans le paramètre instanceContext de PrjStartVirtualizing.

Si le fournisseur n’a pas spécifié ce contexte, cette valeur est NULL.

Configuration requise