Share via

WofIsExternalFile 함수(wofapi.h)

  • 아티클

실제 파일 또는 시스템 데이터 공급자가 파일을 백업하는지 확인하는 데 사용되며, 필요에 따라 파일에 대한 공급자 또는 추가 데이터를 나타냅니다.

구문

HRESULT WofIsExternalFile(
  [in]                LPCWSTR FilePath,
  [out, optional]     PBOOL   IsExternalFile,
  [out, optional]     PULONG  Provider,
  [out, optional]     PVOID   ExternalFileInfo,
  [in, out, optional] PULONG  BufferLength
);

매개 변수

[in] FilePath

지원 상태가 필요한 파일의 경로를 지정합니다.

[out, optional] IsExternalFile

필요에 따라 BOOL 값을 가리킵니다. 반환이 성공적이면 개체가 외부적으로 백업되는 경우 이 값은 TRUE이고 실제 파일인 경우 FALSE가 됩니다.

[out, optional] Provider

필요에 따라 ULONG 값을 가리킵니다. 반환이 성공하면 이 값은 외부에서 이 개체를 백업하는 공급자로 설정됩니다. 현재 정의된 공급자는 다음과 같습니다.

WOF_PROVIDER_WIM 파일의 데이터가 별도의 WIM 파일에 있음을 나타냅니다. 액세스에서 데이터는 투명하게 추출되고 압축을 풀고 애플리케이션에 제공됩니다. 파일 내용이 수정되면 데이터가 투명하게 압축 해제되고 파일이 일반 파일로 복원됩니다.
WOF_PROVIDER_FILE 파일의 데이터를 압축하고 파일 자체와 함께 저장해야 했음을 나타냅니다. 액세스에서 데이터는 투명하게 압축을 풀고 애플리케이션에 제공됩니다. 파일 내용이 수정되면 데이터가 투명하게 압축 해제되고 파일이 일반 파일로 복원됩니다. 이 공급자에는 Windows 10 필요합니다.

[out, optional] ExternalFileInfo

필요에 따라 호출자가 할당한 버퍼를 가리킵니다. 반환이 성공적이면 이 버퍼에는 파일 상태에 대한 추가 정보가 포함됩니다. 이 값이 제공되면 BufferLength 도 지정해야 합니다. 정의된 각 공급자에 대한 데이터 구조는 다음과 같습니다.

WOF_PROVIDER_WIM WIM_EXTERNAL_FILE_INFO
WOF_PROVIDER_FILE WOF_FILE_COMPRESSION_INFO

[in, out, optional] BufferLength

필요에 따라 ExternalFileInfo에 지정된 버퍼의 길이가 포함된 값을 가리킵니다. 반환 시 이 값은 사용된 버퍼의 크기 또는 필요한 버퍼의 크기로 설정됩니다. 버퍼 길이가 부족한 경우 이 함수는 필요한 크기를 나타내는 데 성공하며 ExternalFileInfo에서 버퍼를 채우지 않습니다. 이 길이는 위에 정의된 구조체 중 하나에 해당해야 합니다.

WOF_PROVIDER_WIM sizeof(WIM_EXTERNAL_FILE_INFO)
WOF_PROVIDER_FILE sizeof(WOF_FILE_COMPRESSION_INFO)

반환 값

이 함수는 성공 또는 실패 이유를 나타내는 HRESULT를 반환합니다. ExternalFileInfo에 지정된 버퍼의 크기가 올바르지 않으면 함수는 S_OK 반환하고 BufferLength에서 필요한 버퍼 크기를 나타냅니다.

요구 사항

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

추가 정보

FSCTL_GET_EXTERNAL_BACKING