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
| Client minimal pris en charge | Windows 10, version 1709 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2016 [applications de bureau uniquement] |
| En-tête | cfapi.h |