Funzione CfGetPlaceholderStateFromAttributeTag (cfapi.h)
Ottiene un set di stati segnaposto in base ai valori FileAttributes e ReparseTag del file.
Sintassi
CF_PLACEHOLDER_STATE CfGetPlaceholderStateFromAttributeTag(
[in] DWORD FileAttributes,
[in] DWORD ReparseTag
);
Parametri
[in] FileAttributes
Informazioni sull'attributo del file.
[in] ReparseTag
Informazioni sul tag reparse da un file.
Valore restituito
Può includere CF_PLACEHOLDER_STATE; stato segnaposto.
Commenti
È possibile ottenere FileAttributes e ReparseTag elencando la directory contenente il file o eseguendo direttamente una query su FileAttributeTagInfo nel file.
È possibile restituire i valori CF_PLACEHOLDER_STATE seguenti:
| Stato segnaposto | Descrizione | | CF_PLACEHOLDER_STATE_NO_STATES | Quando viene restituito, il file o la directory i cui attributi e tag reparse esaminati dall'API non sono un segnaposto per i file cloud. | | CF_PLACEHOLDER_STATE_PLACEHOLDER | Se impostato, il file o la directory i cui attributi e tag reparse esaminati dall'API sono un segnaposto per i file cloud. | | CF_PLACEHOLDER_STATE_SYNC_ROOT | Se impostata, la directory non è solo una directory segnaposto dei file cloud, ma anche la radice di sincronizzazione. | | CF_PLACEHOLDER_STATE_ESSENTIAL_PROP_PRESENT | Se impostato, il file o la directory deve essere un segnaposto per i file cloud ed esiste una proprietà essenziale nell'archivio delle proprietà del file o della directory. | | CF_PLACEHOLDER_STATE_IN_SYNC | Se impostato, il file o la directory deve essere un segnaposto per i file cloud e il relativo contenuto è sincronizzato con il cloud. | | CF_PLACEHOLDER_STATE_PARTIAL | Se impostato, il file o la directory deve essere un segnaposto per i file cloud e il relativo contenuto non è pronto per essere utilizzato dall'applicazione utente (anche se può o non essere completamente presente in locale). Un esempio è un file segnaposto il cui contenuto è stato scaricato completamente nel disco locale, ma ancora da convalidare da un provider di sincronizzazione che ha registrato la radice di sincronizzazione con il modificatore di idratazione VERIFICATION_REQUIRED. | | CF_PLACEHOLDER_STATE_PARTIALLY_ON_DISK | Se impostato, il file o la directory deve essere un segnaposto per i file cloud e il relativo contenuto non è completamente presente in locale. Quando PARTIALLY_ON_DISK è impostato, è necessario impostare anche PARTIAL. | | CF_PLACEHOLDER_STATE_INVALID | Si tratta di uno stato non valido quando l'API non riesce ad analizzare le varie informazioni del file o della directory. |
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 10 versione 1709 [solo app desktop] |
Server minimo supportato | Windows Server 2016 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | cfapi.h |
Libreria | CldApi.lib |
DLL | CldApi.dll |