CF_PLACEHOLDER_CREATE_INFO-Struktur (cfapi.h)

Enthält Platzhalterinformationen zum Erstellen neuer Platzhalterdateien oder Verzeichnisse.

Syntax

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;

Member

RelativeFileName

Der Name der zu erstellenden untergeordneten Platzhalterdatei oder des untergeordneten Verzeichnisses. Sie sollte nur aus dem Datei- oder Verzeichnisnamen bestehen.

Wenn der Synchronisierungsstamm des Anbieters z. B. C:\Sync placeholder.txt Root ist, rufen Sie die CfCreatePlaceholders-FunktionaufC:\SyncRoot\SubDirectory, und legen Sie das Feld RelativePathName des CF_PLACEHOLDER_CREATE_INFO auf placeholder.txtfest.

FsMetadata

Dateisystemmetadaten, die mit dem Platzhalter erstellt werden sollen, einschließlich aller Zeitstempel, Dateiattribute und Dateigröße (optional für Verzeichnisse).

FileIdentity

Ein Benutzermoduspuffer mit Dateiinformationen, die vom Synchronisierungsanbieter bereitgestellt werden. Das FileIdentity-Blob sollte CF_PLACEHOLDER_MAX_FILE_IDENTITY_LENGTH (definiert in 4 KB) nicht überschreiten. FileIdentity wird in allen Rückrufen an den Synchronisierungsanbieter zurückgegeben. Dies ist für Dateien erforderlich (nicht für Verzeichnisse).

FileIdentityLength

Länge der FileIdentity in Byte.

Flags

Flags zum Angeben des Platzhaltererstellungsverhaltens. Weitere Informationen finden Sie unter CF_PLACEHOLDER_CREATE_FLAGS .

Result

Das Ergebnis der Platzhaltererstellung. Bei erfolgreicher Erstellung wird der Wert STATUS_OK.

CreateUsn

Der endgültige USN-Wert, nachdem Die Erstellungsaktionen ausgeführt wurden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Kopfzeile	cfapi.h

Weitere Informationen

CF_PLACEHOLDER_CREATE_FLAGS

CfCreatePlaceholders