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 |