CfRevertPlaceholder 함수(cfapi.h)

자리 표시자를 일반 파일로 되돌려 재분석 태그, 파일 ID 등과 같은 모든 특수한 특성을 제거합니다.

구문

HRESULT CfRevertPlaceholder(
  [in]                HANDLE          FileHandle,
  [in]                CF_REVERT_FLAGS RevertFlags,
  [in, out, optional] LPOVERLAPPED    Overlapped
);

매개 변수

[in] FileHandle

일반 파일 또는 디렉터리로 되돌리려는 파일 또는 디렉터리 자리 표시자에 대한 핸들입니다. 플랫폼은 되돌리기 작업을 다른 활성 요청과 올바르게 동기화합니다. 특성 또는 액세스 권한 없음 핸들로 충분합니다.

[in] RevertFlags

자리 표시자 되돌리기 플래그입니다. RevertFlags는CF_REVERT_FLAG_NONE 설정해야 합니다.

[in, out, optional] Overlapped

지정되고 비동기 FileHandle과 결합된 경우 Overlapped 를 사용하면 플랫폼에서 CfRevertPlaceholder 호출을 비동기적으로 수행할 수 있습니다. 자세한 내용은 설명을 참조하세요 .

지정하지 않으면 플랫폼은 핸들을 만든 방법에 관계없이 동기적으로 API 호출을 수행합니다.

반환 값

이 함수가 성공하면 를 반환합니다 S_OK. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

호출자는 되돌리려면 자리 표시자에 대한 WRITE_DATA 또는 WRITE_DAC 액세스 권한이 있어야 합니다.

호출 시 자리 표시자가 아직 완전히 수화되지 않은 경우 필터는 동기화 공급자에게 FETCH_DATA 콜백을 보내 파일을 수화합니다. 파일을 수화할 수 없는 경우 상태 STATUS_CLOUD_FILE_ACCESS_DENIED 되돌리기 실패합니다.

겹침을 비동기적으로 사용할 때 API가 HRESULT_FROM_WIN32(ERROR_IO_PENDING)를 반환하는 경우 호출자는 GetOverlappedResult를 사용하여 대기할 수 있습니다.

요구 사항

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

추가 정보

GetOverlappedResult

CF_REVERT_FLAGS