Funzione CfGetPlaceholderInfo (cfapi.h)
Ottiene varie caratteristiche di un file segnaposto o di una cartella. Se il file non è un segnaposto file cloud, l'API avrà esito negativo. In caso di esito positivo, le informazioni vengono restituite in base alla richiesta di InfoClass specifica.
Sintassi
HRESULT CfGetPlaceholderInfo(
[in] HANDLE FileHandle,
[in] CF_PLACEHOLDER_INFO_CLASS InfoClass,
[out] PVOID InfoBuffer,
[in] DWORD InfoBufferLength,
[out, optional] PDWORD ReturnedLength
);
Parametri
[in] FileHandle
Handle al segnaposto le cui informazioni verranno sottoposte a query. A differenza della maggior parte delle API dei file cloud che accettano un handle di file, questa non modifica il file in alcun modo. Pertanto, l'handle di file richiede solo l'accesso READ_ATTRIBUTES .
[in] InfoClass
Informazioni segnaposto. Questa opzione può essere impostata su CF_PLACEHOLDER_STANDARD_INFO o CF_PLACEHOLDER_BASIC_INFO.
[out] InfoBuffer
Puntatore a un buffer che riceverà informazioni sul segnaposto.
[in] InfoBufferLength
Lunghezza dell'InfoBuffer, in byte. Se il buffer non è abbastanza grande per contenere tutte le informazioni richieste, l'API restituirà quanti dati possono essere inseriti nel buffer e la chiamata avrà esito negativo con HRESULT_FROM_WIN32(ERROR_MORE_DATA).
[out, optional] ReturnedLength
Numero di byte restituiti in InfoBuffer.
Valore restituito
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Le informazioni segnaposto includono gli attributi seguenti:
| Attributo | Descrizione |
|---|---|
| OnDiskDataSize | Numero totale di byte su disco. |
| ValidatedDataSize | Numero totale di byte sincronizzati con il cloud. |
| ModifiedDataSize | Numero totale di byte sovrascritti/accodati in locale, ad esempio non sincronizzati con il cloud. |
| ProprietàSize | Numero totale di byte nel disco utilizzato da tutti i BLOB delle proprietà. |
| PinState | Per altre informazioni, vedere CfSetPinState . |
| InSyncState | Per altre informazioni, vedere CfSetInSyncState . |
| FileId | Numero di volume a 64 bit wide non volatile che identifica in modo univoco un file o una directory. |
| SyncRootFileId | ID file della directory radice di sincronizzazione in cui risiede il file le cui informazioni segnaposto devono essere sottoposte a query. |
| FileIdentity | BLOB opaco fornito dal provider di sincronizzazione alla piattaforma quando è stato creato il segnaposto. L'identità file viene fornita per tutti i callback del provider di sincronizzazione. |
| FileIdentityLength | Lunghezza dell'identità del file in byte. |
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 |