Funzione CfHydratePlaceholder (cfapi.h)

Idrata un file segnaposto assicurandosi che l'intervallo di byte specificato sia presente su disco nel segnaposto. Questa opzione è valida solo per i file.

Sintassi

HRESULT CfHydratePlaceholder(
  [in]                HANDLE           FileHandle,
  [in]                LARGE_INTEGER    StartingOffset,
  [in]                LARGE_INTEGER    Length,
  [in]                CF_HYDRATE_FLAGS HydrateFlags,
  [in, out, optional] LPOVERLAPPED     Overlapped
);

Parametri

[in] FileHandle

Handle del file segnaposto da idratare. È sufficiente un handle di attributo o senza accesso.

[in] StartingOffset

Offset del punto iniziale dei dati del file segnaposto.

[in] Length

Lunghezza, in byte, del file segnaposto i cui dati devono essere disponibili localmente sul disco al termine dell'API. La lunghezza ( CF_EOF definita come -1) indica la fine del file. Per qualsiasi sottoinsieme non presente nel segnaposto, la piattaforma recupererà i dati dal provider di sincronizzazione e lo archivierà su disco nel segnaposto.

[in] HydrateFlags

Flag di idratazione segnaposto. I flag idratati devono essere impostati su CF_HYDRATE_FLAG_NONE.

[in, out, optional] Overlapped

Se specificato e combinato con un FileHandle asincrono, Overlapped consente alla piattaforma di eseguire la chiamata CfHydratePlaceholder 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 READ_DATA o WRITE_DAC l'accesso al segnaposto da idratare.

Se l'API restituisce HRESULT_FROM_WIN32(ERROR_IO_PENDING) quando si usa Sovrapposizione in modo asincrono, il chiamante può attendere usando GetOverlappedResult.

Requisiti

Vedi anche

GetOverlappedResult