Funzione CfRevertPlaceholder (cfapi.h)
Ripristina un segnaposto in un file normale, rimuovendo tutte le caratteristiche speciali, ad esempio il tag reparse, l'identità del file e così via.
Sintassi
HRESULT CfRevertPlaceholder(
[in] HANDLE FileHandle,
[in] CF_REVERT_FLAGS RevertFlags,
[in, out, optional] LPOVERLAPPED Overlapped
);
Parametri
[in] FileHandle
Handle per il segnaposto di file o directory che sta per essere ripristinato in un file o in una directory normale. La piattaforma sincronizza correttamente l'operazione di ripristino con altre richieste attive. È sufficiente un handle di attributo o senza accesso.
[in] RevertFlags
Contrassegni di ripristino segnaposto. È necessario impostare RevertFlags su CF_REVERT_FLAG_NONE.
[in, out, optional] Overlapped
Se specificato e combinato con un oggetto FileHandle asincrono, Overlapped consente alla piattaforma di eseguire la chiamata CfRevertPlaceholder in modo asincrono. Per altri dettagli, vedere la sezione Osservazioni .
Se non specificato, la piattaforma eseguirà la chiamata API in modo sincrono, indipendentemente dalla modalità di creazione dell'handle.
Valore restituito
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Il chiamante deve avere WRITE_DATA o WRITE_DAC l'accesso al segnaposto da ripristinare.
Se il segnaposto non è già completamente idratato al momento della chiamata, il filtro invierà un callback FETCH_DATA al provider di sincronizzazione per idratare il file. Se il file non può essere idratato, il ripristino avrà esito negativo con stato STATUS_CLOUD_FILE_ACCESS_DENIED.
Se l'API restituisce HRESULT_FROM_WIN32(ERROR_IO_PENDING) quando si usa sovrapposta in modo asincrono, il chiamante può attendere usando GetOverlappedResult.
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 |