struttura CF_PLACEHOLDER_CREATE_INFO (cfapi.h)
Contiene informazioni segnaposto per la creazione di nuovi file segnaposto o directory.
Sintassi
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;
Members
RelativeFileName
Nome del file segnaposto figlio o della directory da creare. Deve essere costituito solo dal nome del file o della directory.
Ad esempio, se la radice di sincronizzazione del provider è C:\SyncRoot, per creare un segnaposto denominato placeholder.txt in una sottodirectory della radice di sincronizzazione, chiamare la funzione CfCreatePlaceholders con BaseDirectoryPath uguale a C:\SyncRoot\SubDirectory e impostare il campo RelativePathName del CF_PLACEHOLDER_CREATE_INFO su placeholder.txt.
FsMetadata
Metadati del file system da creare con il segnaposto, inclusi tutti i timestamp, gli attributi del file e le dimensioni del file (facoltativi per le directory).
FileIdentity
Buffer in modalità utente contenente le informazioni sul file fornite dal provider di sincronizzazione. Il BLOB FileIdentity non deve superare le dimensioni CF_PLACEHOLDER_MAX_FILE_IDENTITY_LENGTH (definite a 4 KB). FileIdentity viene restituito al provider di sincronizzazione in tutti i callback. Questa operazione è necessaria per i file (non per le directory).
FileIdentityLength
Lunghezza, in byte, di FileIdentity.
Flags
Flag per specificare il comportamento di creazione del segnaposto. Per altre informazioni, vedere CF_PLACEHOLDER_CREATE_FLAGS .
Result
Risultato della creazione del segnaposto. Al termine della creazione, il valore è STATUS_OK.
CreateUsn
Valore USN finale dopo l'esecuzione delle azioni di creazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 10 versione 1709 [solo app desktop] |
| Server minimo supportato | Windows Server 2016 [solo app desktop] |
| Intestazione | cfapi.h |