Editar

CfGetPlaceholderRangeInfo function (cfapi.h)

  • Artículo
  • Tiempo de lectura: 2 minutos

Gets range information about a placeholder file or folder.

Syntax

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

Parameters

[in] FileHandle

The handle of the placeholder file to be queried.

[in] InfoClass

Types of the range of placeholder data.

[in] StartingOffset

Offset of the starting point of the range of data.

[in] Length

Length of the range of data.

[out] InfoBuffer

Pointer to a buffer to receive the data.

[in] InfoBufferLength

Length, in bytes, of InfoBuffer.

[out, optional] ReturnedLength

The length of the returned range of placeholder data in the InfoBuffer.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Unlike most placeholder APIs that take a file handle, this one does not modify the file in any way, therefore the file handle only requires READ_ATTRIBUTES access.

Requirements

   
Minimum supported client Windows 10, version 1709 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header cfapi.h
Library CldApi.lib
DLL CldApi.dll