CfGetPlaceholderRangeInfo 함수(cfapi.h)

자리 표시자 파일 또는 폴더에 대한 범위 정보를 가져옵니다.

구문

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

매개 변수

[in] FileHandle

쿼리할 자리 표시자 파일의 핸들입니다.

[in] InfoClass

자리 표시자 데이터 범위의 형식입니다.

[in] StartingOffset

데이터 범위의 시작점 오프셋입니다.

[in] Length

데이터 범위의 길이입니다. 공급자는 Length를 지정 CF_EOF 하여 정보가 요청되는 범위가 StartingOffset에서 파일 끝까지임을 나타낼 수 있습니다.

[out] InfoBuffer

데이터를 수신할 버퍼에 대한 포인터입니다. 버퍼는 요청된 범위를 설명하는 오프셋/길이 쌍인 CF_FILE_RANGE 구조체의 배열입니다.

[in] InfoBufferLength

InfoBuffer의 길이(바이트)입니다.

[out, optional] ReturnedLength

InfoBuffer에서 반환된 자리 표시자 데이터 범위의 길이입니다.

반환 값

이 함수가 성공하면 를 반환합니다 S_OK. 그러지 않으면 HRESULT 오류 코드를 반환합니다. 몇 가지 일반적인 오류 코드는 다음 표에 나와 있습니다.

오류 코드	의미
HRESULT_FROM_WIN32( ERROR_HANDLE_EOF )	즉 , StartingOffset>= 파일 끝의 위치입니다.
HRESULT_FROM_WIN32( ERROR_MORE_DATA )	이는 다음 CF_FILE_RANGE 항목이 제공된 버퍼에 맞지 않음을 의미합니다. 호출자는 반환된 InfoBufferWritten 값을 사용하여 항목이 수신되었는지 여부를 확인해야 합니다.

설명

파일 핸들을 사용하는 대부분의 자리 표시자 API와 달리 이 API는 어떤 방식으로도 파일을 수정하지 않으므로 파일 핸들에는 READ_ATTRIBUTES 액세스만 필요합니다.

요구 사항

지원되는 최소 클라이언트	Windows 10 버전 1709 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	cfapi.h
라이브러리	CldApi.lib
DLL	CldApi.dll

추가 정보

CfGetPlaceholderRangeInfoForHydration