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 |