Partager via

CF_PLACEHOLDER_CREATE_INFO structure (cfapi.h)

  • Article

Contient des informations d’espace réservé pour la création de nouveaux fichiers ou répertoires d’espace réservé.

Syntaxe

typedef struct CF_PLACEHOLDER_CREATE_INFO {
  LPCWSTR                     RelativeFileName;
  CF_FS_METADATA              FsMetadata;
  LPCVOID                     FileIdentity;
  DWORD                       FileIdentityLength;
  CF_PLACEHOLDER_CREATE_FLAGS Flags;
  HRESULT                     Result;
  USN                         CreateUsn;
} CF_PLACEHOLDER_CREATE_INFO;

Membres

RelativeFileName

Nom du répertoire ou du fichier d’espace réservé enfant à créer. Il doit se composer uniquement du nom du fichier ou du répertoire.

Par exemple, si la racine de synchronisation du fournisseur est C :\SyncRoot, pour créer un espace réservé nommé placeholder.txt dans un sous-répertoire de la racine de synchronisation, appelez la fonction CfCreatePlaceholders avec BaseDirectoryPath égal à C:\SyncRoot\SubDirectory et définissez le champ RelativePathName du CF_PLACEHOLDER_CREATE_INFO sur placeholder.txt.

FsMetadata

Métadonnées du système de fichiers à créer avec l’espace réservé, y compris tous les horodatages, attributs de fichier et taille de fichier (facultatif pour les répertoires).

FileIdentity

Mémoire tampon en mode utilisateur contenant les informations de fichier fournies par le fournisseur de synchronisation. La taille de l’objet blob FileIdentity ne doit pas dépasser CF_PLACEHOLDER_MAX_FILE_IDENTITY_LENGTH (définie sur 4 Ko). FileIdentity est repassé au fournisseur de synchronisation dans tous les rappels. Cela est requis pour les fichiers (et non pour les répertoires).

FileIdentityLength

Longueur, en octets, de FileIdentity.

Flags

Indicateurs permettant de spécifier le comportement de création d’espace réservé. Pour plus d’informations, consultez CF_PLACEHOLDER_CREATE_FLAGS .

Result

Résultat de la création de l’espace réservé. En cas de création réussie, la valeur est STATUS_OK.

CreateUsn

Valeur USN finale après l’exécution des actions de création.

Configuration requise

Condition requise Valeur
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

Voir aussi

CF_PLACEHOLDER_CREATE_FLAGS

CfCreatePlaceholders