Função CfRevertPlaceholder (cfapi.h)

Reverte um espaço reservado de volta para um arquivo regular, retirando todas as características especiais, como a marca de nova análise, a identidade do arquivo etc.

Sintaxe

HRESULT CfRevertPlaceholder(
  [in]                HANDLE          FileHandle,
  [in]                CF_REVERT_FLAGS RevertFlags,
  [in, out, optional] LPOVERLAPPED    Overlapped
);

Parâmetros

[in] FileHandle

Um identificador para o espaço reservado de arquivo ou diretório que está prestes a ser revertido para um arquivo ou diretório normal. A plataforma sincroniza corretamente a operação de reverter com outras solicitações ativas. Um identificador de atributo ou sem acesso é suficiente.

[in] RevertFlags

Espaço reservado reverter sinalizadores. RevertFlags deve ser definido como CF_REVERT_FLAG_NONE.

[in, out, optional] Overlapped

Quando especificado e combinado com um FileHandle assíncrono, Overlapped permite que a plataforma execute a chamada CfRevertPlaceholder de forma assíncrona. Confira 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 WRITE_DATA ou WRITE_DAC acesso ao espaço reservado a ser revertido.

Se o espaço reservado ainda não estiver totalmente hidratado no momento da chamada, o filtro enviará um retorno de chamada FETCH_DATA para o provedor de sincronização para hidratar o arquivo. Se o arquivo não puder ser hidratado, o reverter falhará com status STATUS_CLOUD_FILE_ACCESS_DENIED.

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

Requisitos

Confira também

GetOverlappedResult

CF_REVERT_FLAGS