FSCTL_GET_EXTERNAL_BACKING 제어 코드
FSCTL_GET_EXTERNAL_BACKING 제어 코드는 외부 지원 공급자로부터 파일에 대한 백업 정보를 가져옵니다. 지원 공급자에는 WIM(Windows 이미지 형식) 공급자 또는 개별 압축 파일 공급자가 포함됩니다. 외부에서 지원되는 파일의 콘텐츠는 쿼리된 파일이 포함된 볼륨 이외의 볼륨에 있을 수 있습니다.
이 작업을 수행하려면 다음 매개 변수 를 사용하여 FltFsControlFile 또는 ZwFsControlFile 을 호출합니다.
매개 변수
인스턴스 [in]
FltFsControlFile만 해당 합니다. 호출자에 대한 불투명 인스턴스 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileObject [in]
FltFsControlFile만 해당 합니다. 백업 정보를 쿼리하는 파일의 파일 포인터 개체입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileHandle [in]
ZwFsControlFile만 해당 합니다. 백업 정보를 쿼리하는 파일의 핸들입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FsControlCode [in]
작업에 대한 제어 코드입니다. 이 작업에 는 FSCTL_GET_EXTERNAL_BACKING 사용합니다.
InputBuffer [in]
없음 NULL로 설정합니다.
InputBufferLength [in]
0으로 설정합니다.
OutputBuffer [out]
출력 버퍼에 대한 포인터로, WOF_EXTERNAL_INFO 구조와 공급자 데이터를 받을 수 있을 만큼 크기가 커야 합니다. WIM 지원 파일의 경우 WOF_EXTERNAL_INFO뒤에 WIM_PROVIDER_EXTERNAL_INFO 구조가 있습니다. 개별적으로 압축된 파일의 경우 WOF_EXTERNAL_INFO 뒤에 FILE_PROVIDER_EXTERNAL_INFO_V1 구조가 뒤따릅니다.
OutputBufferLength [out]
OutputBuffer가 가리키는 버퍼의 크기(바이트)입니다.
LengthReturned
성공적으로 완료될 때 OutputBuffer 에 기록된 바이트 수를 지정합니다.
상태 블록
FltFsControlFile 또는 ZwFsControlFile 은 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 함수가 다음 NTSTATUS 값 중 하나를 반환할 수 있습니다.
| 용어 | 설명 |
|---|---|
STATUS_OBJECT_NOT_EXTERNALLY_BACKED |
파일이 외부적으로 지원되지 않습니다. |
STATUS_INVALID_DEVICE_REQUEST |
지원 서비스가 없거나 시작되지 않았습니다. |
설명
업데이트할 데이터 원본에 대한 지원 공급자가 WIM 파일인 경우 출력 버퍼에는 WOF_EXTERNAL_INFO 구조와 WIM_PROVIDER_EXTERNAL_INFO 구조가 포함됩니다. OutputBufferLength는 적어도 sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_EXTERNAL_INFO)여야 합니다. 지원 공급자가 개별적으로 압축된 파일인 경우 출력 버퍼에는 WOF_EXTERNAL_INFO 구조와 FILE_PROVIDER_EXTERNAL_INFO_V1 구조가 포함됩니다.
요구 사항
Version |
Windows 8.1 Update 시작해서 사용할 수 있습니다. |
헤더 |
Ntifs.h(Ntifs.h 또는 Fltkernel.h 포함) |