Share via

WofSetFileDataLocation 함수(wofapi.h)

  • 아티클

파일을 물리적 파일 백업에서 시스템 데이터 공급자 백업으로 변경하는 데 사용됩니다.

구문

HRESULT WofSetFileDataLocation(
  [in] HANDLE FileHandle,
  [in] ULONG  Provider,
  [in] PVOID  ExternalFileInfo,
  [in] ULONG  Length
);

매개 변수

[in] FileHandle

CreateFile 또는 유사한 API를 사용하여 연 파일에 대한 핸들입니다.

[in] Provider

이 파일을 지원하는 공급자를 나타냅니다. 현재 정의된 공급자는 다음과 같습니다.

WOF_PROVIDER_WIM WIM 파일에서 파일의 데이터를 가져와야 했음을 나타냅니다. 액세스 시 데이터는 WIM 파일에서 투명하게 추출되어 애플리케이션에 제공됩니다. 파일 내용이 수정되면 데이터가 투명하게 압축 해제되고 이 API를 사용하지 않은 경우 파일이 동일한 실제 형식으로 복원됩니다.
WOF_PROVIDER_FILE 파일의 데이터를 압축하고 파일 자체와 함께 저장해야 했음을 나타냅니다. 액세스에서 데이터는 투명하게 압축을 풀고 애플리케이션에 제공됩니다. 파일 내용이 수정되면 데이터가 투명하게 압축 해제되고 이 API를 사용하지 않은 경우 파일이 동일한 실제 형식으로 복원됩니다. 이 공급자에는 Windows 10 필요합니다.

[in] ExternalFileInfo

지정된 공급자와 관련된 데이터를 제공합니다. 정의된 각 공급자에 대한 데이터 구조는 다음과 같습니다.

WOF_PROVIDER_WIM WIM_EXTERNAL_FILE_INFO
WOF_PROVIDER_FILE WOF_FILE_COMPRESSION_INFO

[in] Length

공급자별 데이터의 길이(바이트)를 지정합니다. 이는 위에 정의된 구조체에 해당해야 합니다.

WOF_PROVIDER_WIM sizeof(WIM_EXTERNAL_FILE_INFO)
WOF_PROVIDER_FILE sizeof(WOF_FILE_COMPRESSION_INFO)

반환 값

이 함수는 성공 또는 실패 이유를 나타내는 HRESULT를 반환합니다.

설명

WOF_PROVIDER_FILE 사용하는 경우 ERROR_COMPRESSION_NOT_BENEFICIAL 작업이 실패할 수 있습니다. 이는 데이터를 압축하려고 했지만 디스크 공간이 저장되지 않았기 때문에 파일이 압축되지 않음을 나타냅니다. 대부분의 애플리케이션에서 성공 조건으로 처리할 수 있습니다.

요구 사항

요구 사항 값
대상 플랫폼 Windows
헤더 wofapi.h
라이브러리 Wofutil.lib
DLL Wofutil.dll

추가 정보

FSCTL_SET_EXTERNAL_BACKING