Funzione CfGetPlaceholderRangeInfo (cfapi.h)

Articolo
04/06/2023

Ottiene informazioni sull'intervallo su un file o una cartella segnaposto.

Sintassi

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
);

Parametri

[in] FileHandle

Handle del file segnaposto su cui eseguire una query.

[in] InfoClass

Tipi dell'intervallo di dati segnaposto.

[in] StartingOffset

Offset del punto iniziale dell'intervallo di dati.

[in] Length

Lunghezza dell'intervallo di dati. Un provider può specificare CF_EOF per Length per indicare che l'intervallo per cui sono richieste informazioni è da StartingOffset alla fine del file.

[out] InfoBuffer

Puntatore a un buffer che riceverà i dati. Il buffer è una matrice di strutture CF_FILE_RANGE , ovvero coppie di offset/lunghezza, che descrivono gli intervalli richiesti.

[in] InfoBufferLength

Lunghezza di InfoBuffer in byte.

[out, optional] ReturnedLength

Lunghezza dell'intervallo restituito di dati segnaposto in InfoBuffer.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Nella tabella seguente sono elencati alcuni codici di errore comuni:

Codice di errore	Significato
HRESULT_FROM_WIN32( ERROR_HANDLE_EOF )	Ciò significa che StartingOffset>= la posizione della fine del file.
HRESULT_FROM_WIN32( ERROR_MORE_DATA )	Ciò implica che la voce di CF_FILE_RANGE successiva non rientra nel buffer fornito. Il chiamante deve verificare se una voce viene ricevuta o meno utilizzando il valore InfoBufferWritten restituito.

Commenti

A differenza della maggior parte delle API segnaposto che accettano un handle di file, questa non modifica il file in alcun modo, pertanto l'handle di file richiede solo READ_ATTRIBUTES accesso.

Requisiti


Client minimo supportato	Windows 10 versione 1709 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	cfapi.h
Libreria	CldApi.lib
DLL	CldApi.dll

Vedi anche

CfGetPlaceholderRangeInfoForHydration

Condividi tramite