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 |