CfHydratePlaceholder 함수(cfapi.h)
지정된 바이트 범위가 자리 표시자에 디스크에 있는지 확인하여 자리 표시자 파일을 수화합니다. 파일에만 유효합니다.
구문
HRESULT CfHydratePlaceholder(
[in] HANDLE FileHandle,
[in] LARGE_INTEGER StartingOffset,
[in] LARGE_INTEGER Length,
[in] CF_HYDRATE_FLAGS HydrateFlags,
[in, out, optional] LPOVERLAPPED Overlapped
);
매개 변수
[in] FileHandle
하이드레이션할 자리 표시자 파일의 핸들입니다. 특성 또는 액세스 권한 없음 핸들로 충분합니다.
[in] StartingOffset
자리 표시자 파일 데이터의 시작점 오프셋입니다.
[in] Length
API가 성공적으로 완료된 후 디스크에서 데이터를 로컬로 사용할 수 있어야 하는 자리 표시자 파일의 길이(바이트)입니다. 길이 CF_EOF (-1로 정의됨)는 파일의 끝을 나타냅니다. 자리 표시자에 없는 하위 범위의 경우 플랫폼은 동기화 공급자에서 데이터를 가져와서 자리 표시자의 디스크에 저장합니다.
[in] HydrateFlags
자리 표시자 하이드레이션 플래그입니다. HydrateFlags는CF_HYDRATE_FLAG_NONE 설정해야 합니다.
[in, out, optional] Overlapped
지정하고 비동기 FileHandle과 결합하면 Overlapped 를 사용하면 플랫폼이 CfHydratePlaceholder 호출을 비동기적으로 수행할 수 있습니다. 자세한 내용은 비고를 참조하세요.
지정하지 않으면 플랫폼은 핸들을 만든 방법에 관계없이 API 호출을 동기적으로 수행합니다.
반환 값
이 함수가 성공하면 를 반환합니다 S_OK. 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
호출자는 수화할 자리 표시자에 대한 READ_DATA 또는 WRITE_DAC 액세스 권한이 있어야 합니다.
겹침을 비동기적으로 사용할 때 API가 HRESULT_FROM_WIN32(ERROR_IO_PENDING)를 반환하는 경우 호출자는 GetOverlappedResult를 사용하여 대기할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1709 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2016 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | cfapi.h |
| 라이브러리 | CldApi.lib |
| DLL | CldApi.dll |