structure CF_CALLBACK_INFO (cfapi.h)

Contient des informations de rappel courantes telles que le type de rappel, le processus utilisateur qui déclenche le rappel et les informations de base sur le fichier sur lequel le rappel est demandé.

Syntaxe

typedef struct CF_CALLBACK_INFO {
  DWORD               StructSize;
  CF_CONNECTION_KEY   ConnectionKey;
  LPVOID              CallbackContext;
  PCWSTR              VolumeGuidName;
  PCWSTR              VolumeDosName;
  DWORD               VolumeSerialNumber;
  LARGE_INTEGER       SyncRootFileId;
  LPCVOID             SyncRootIdentity;
  DWORD               SyncRootIdentityLength;
  LARGE_INTEGER       FileId;
  LARGE_INTEGER       FileSize;
  LPCVOID             FileIdentity;
  DWORD               FileIdentityLength;
  PCWSTR              NormalizedPath;
  CF_TRANSFER_KEY     TransferKey;
  UCHAR               PriorityHint;
  PCORRELATION_VECTOR CorrelationVector;
  CF_PROCESS_INFO     *ProcessInfo;
  CF_REQUEST_KEY      RequestKey;
} CF_CALLBACK_INFO;

Membres

StructSize

Taille de CF_CALLBACK_INFO.

ConnectionKey

Handle opaque créé par CfConnectSyncRoot pour une racine de synchronisation gérée par le fournisseur de synchronisation. ConnectionKey est retourné pour des raisons pratiques, de sorte que le fournisseur de synchronisation n’a pas besoin de le suivre manuellement.

CallbackContext

Pointe vers un objet blob opaque fourni par le fournisseur de synchronisation au moment de la connexion racine de synchronisation. CallbackContext est retourné pour des raisons pratiques, de sorte que le fournisseur de synchronisation n’a pas besoin de le suivre manuellement.

VolumeGuidName

Nom GUID du volume sur lequel réside le fichier/répertoire d’espace réservé à traiter. Il se présente sous la forme : « \?\Volume{GUID} ».

VolumeDosName

Lettre de lecteur DOS du volume sous la forme « X: », où X est la lettre de lecteur.

VolumeSerialNumber

Numéro de série du volume.

SyncRootFileId

Un système de fichiers 64 bits géré, id unique à l’échelle du volume de la racine de synchronisation sous laquelle réside le fichier d’espace réservé ou le répertoire à traiter.

SyncRootIdentity

Pointe vers l’objet blob opaque fourni par le fournisseur de synchronisation au moment de l’inscription racine de synchronisation.

SyncRootIdentityLength

Longueur, en octets, de SyncRootIdentity.

FileId

Un système de fichiers 64 bits géré, id unique à l’échelle du volume du fichier d’espace réservé ou du répertoire à traiter.

FileSize

Taille logique du fichier d’espace réservé à traiter. C’est toujours 0 si l’objet du rappel est un répertoire.

FileIdentity

Pointe vers l’objet blob opaque fourni par le fournisseur de synchronisation au moment de la création/conversion/mise à jour de l’espace réservé.

FileIdentityLength

Longueur, en octets, de FileIdentity.

NormalizedPath

Chemin absolu du fichier d’espace réservé ou du répertoire à traiter sur le volume identifié par VolumeGuidName/VolumeDosName. Il commence à partir du répertoire racine du volume. Pour plus d’informations, consultez la section Remarques .

TransferKey

Handle opaque pour le fichier/répertoire d’espace réservé à traiter. Le fournisseur de synchronisation doit le transmettre à l’appel CfExecute pour effectuer l’opération souhaitée sur le fichier/répertoire.

PriorityHint

Une échelle numérique donnée au fournisseur de synchronisation pour décrire la priorité relative d’une extraction par rapport à une autre extraction, afin de fournir l’expérience la plus réactive à l’utilisateur. Les valeurs vont de 0 (priorité la plus faible possible) à 15 (priorité la plus élevée possible), mais sinon, les valeurs n’ont pas de signification spécifique. Le filtre peut ajuster la façon dont il choisit les indicateurs de priorité en fonction des conditions. Le fournisseur de synchronisation est libre d’utiliser l’indicateur comme il le souhaite.

CorrelationVector

Vecteur de corrélation facultatif.

ProcessInfo

Pointe vers une structure CF_PROCESS_INFO qui contient les informations sur le processus utilisateur qui déclenche ce rappel. Il est présent uniquement si le fournisseur de synchronisation spécifie CF_CONNECT_FLAG_REQUIRE_PROCESS_INFO au moment de la connexion racine de synchronisation.

RequestKey

ID opaque qui identifie de manière unique une opération de fichier cloud sur un fichier cloud particulier, comme indiqué par TransferKey. Les fournisseurs de synchronisation n’ont pas besoin d’interpréter ce champ. La seule exigence d’un fournisseur de synchronisation est de le transférer tel qu’il est pour CF_OPERATION_INFO.

Notes

Un nom de fichier est considéré comme normalisé si toutes les conditions suivantes sont remplies :

• Il contient le chemin d’accès complet du répertoire pour le fichier, y compris le nom du volume, sauf si l’utilisateur a ouvert le fichier par ID de fichier, mais n’a pas de privilège de traversée pour l’ensemble du chemin d’accès. (Pour plus d’informations, consultez FltGetFileNameInformation.)
• Le nom du volume est le nom de l’objet d’appareil non persistant du volume (par exemple, « \Device\HarddiskVolume1 »).
• Tous les noms courts sont étendus aux noms longs équivalents.
• Toutes les chaînes de fin « :$DATA » ou « ::$DATA » sont supprimées du nom du flux.
• Tous les points de montage sont résolus.

Spécifications

Voir aussi

CfConnectSyncRoot

CfExecute

CF_PROCESS_INFO

CF_OPERATION_INFO

FltGetFileNameInformation