Função CfGetPlaceholderRangeInfo (cfapi.h)

Obtém informações de intervalo sobre um arquivo ou pasta de espaço reservado.

Sintaxe

HRESULT CfGetPlaceholderRangeInfo(
  [in]            HANDLE                          FileHandle,
  [in]            CF_PLACEHOLDER_RANGE_INFO_CLASS InfoClass,
  [in]            LARGE_INTEGER                   StartingOffset,
  [in]            LARGE_INTEGER                   Length,
  [out]           PVOID                           InfoBuffer,
  [in]            DWORD                           InfoBufferLength,
  [out, optional] PDWORD                          ReturnedLength
);

Parâmetros

[in] FileHandle

O identificador do arquivo de espaço reservado a ser consultado.

[in] InfoClass

Tipos do intervalo de dados de espaço reservado.

[in] StartingOffset

Deslocamento do ponto de partida do intervalo de dados.

[in] Length

Comprimento do intervalo de dados. Um provedor pode especificar CF_EOFpara Length para indicar que o intervalo para o qual as informações são solicitadas é de StartingOffset até o final do arquivo.

[out] InfoBuffer

Ponteiro para um buffer que receberá os dados. O buffer é uma matriz de estruturas de CF_FILE_RANGE , que são pares de deslocamento/comprimento, descrevendo os intervalos solicitados.

[in] InfoBufferLength

O comprimento do InfoBuffer em bytes.

[out, optional] ReturnedLength

O comprimento do intervalo retornado de dados de espaço reservado no InfoBuffer.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT . Alguns códigos de erro comuns são listados na tabela a seguir:

Código do erro	Significado
HRESULT_FROM_WIN32( ERROR_HANDLE_EOF )	Isso significa que StartingOffset>= a posição do final do arquivo.
HRESULT_FROM_WIN32( ERROR_MORE_DATA )	Isso implica que a próxima entrada de CF_FILE_RANGE não se encaixa no buffer fornecido. O chamador deve verificar se alguma entrada é recebida ou não usando o valor InfoBufferWritten retornado.

Comentários

Ao contrário da maioria das APIs de espaço reservado que tomam um identificador de arquivo, essa não modifica o arquivo de forma alguma, portanto, o identificador de arquivo requer apenas READ_ATTRIBUTES acesso.

Requisitos

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

CfGetPlaceholderRangeInfoForHydration