Compartilhar via

Função CfHydratePlaceholder (cfapi.h)

  • Artigo

Hidrata um arquivo de espaço reservado garantindo que o intervalo de bytes especificado esteja presente no disco no espaço reservado. Isso é válido somente para arquivos.

Sintaxe

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

Parâmetros

[in] FileHandle

Identificador do arquivo de espaço reservado a ser hidratado. Um identificador de atributo ou sem acesso é suficiente.

[in] StartingOffset

O deslocamento do ponto de partida dos dados do arquivo de espaço reservado.

[in] Length

O comprimento, em bytes, do arquivo de espaço reservado cujos dados devem estar disponíveis localmente no disco após a conclusão da API com êxito. Um comprimento de CF_EOF (definido como -1) significa o fim do arquivo. Para qualquer subintervalo que não esteja presente no espaço reservado, a plataforma buscará os dados do provedor de sincronização e os armazenará no disco no espaço reservado.

[in] HydrateFlags

Os sinalizadores de hidratação do espaço reservado. HydrateFlags deve ser definido como CF_HYDRATE_FLAG_NONE.

[in, out, optional] Overlapped

Quando especificado e combinado com um FileHandle assíncrono, Overlapped permite que a plataforma execute a chamada cfHydratePlaceholder de forma assíncrona. Consulte os Comentários para obter mais detalhes.

Se não for especificado, a plataforma executará a chamada à API de forma síncrona, independentemente de como o identificador foi criado.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O chamador deve ter READ_DATA ou WRITE_DAC acesso ao espaço reservado para ser hidratado.

Se a API retornar HRESULT_FROM_WIN32(ERROR_IO_PENDING) ao usar Sobreposto de forma assíncrona, o chamador poderá aguardar usando GetOverlappedResult.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1709 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho cfapi.h
Biblioteca CldApi.lib
DLL CldApi.dll

Confira também

GetOverlappedResult