FSCTL_DELETE_EXTERNAL_BACKING 제어 코드
FSCTL_DELETE_EXTERNAL_BACKING 제어 코드는 WIM(Windows 이미지 형식) 공급자 또는 압축된 파일 공급자를 포함하여 외부 지원 공급자와 파일의 연결을 제거합니다. 이 작업의 결과로 백업된 파일의 전체 콘텐츠는 파일로 읽고 압축을 풀고 기록됩니다.
이 작업을 수행하려면 다음 매개 변수 를 사용하여 FltFsControlFile 또는 ZwFsControlFile 을 호출합니다.
매개 변수
인스턴스 [in]: FltFsControlFile만 해당 합니다. 호출자에 대한 불투명 instance 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileObject: [in]: FltFsControlFile만 해당 합니다. 백업 연결이 삭제되는 파일의 파일 포인터 개체입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileHandle [in]: ZwFsControlFile만 해당 합니다. 백업 연결이 삭제되는 파일의 핸들입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FsControlCode [in]: 작업에 대한 제어 코드입니다. 이 작업에 는 FSCTL_DELETE_EXTERNAL_BACKING 사용합니다.
InputBuffer [in]: None. NULL로 설정됨.
InputBufferLength [in]: 를 0으로 설정합니다.
OutputBuffer [out]: None. NULL로 설정됨.
OutputBufferLength [out]: 를 0으로 설정합니다.
상태 블록
FltFsControlFile 또는 ZwFsControlFile 은 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 함수가 다음 NTSTATUS 값 중 하나를 반환할 수 있습니다.
| 코드 | 의미 |
|---|---|
| STATUS_OBJECT_NOT_EXTERNALLY_BACKED | 파일이 외부적으로 백업되지 않습니다. |
| STATUS_INVALID_DEVICE_REQUEST | 지원 서비스가 없거나 시작되지 않았습니다. |
| STATUS_ACCESS_DENIED | 요청자에게 파일에 대한 지원 연결을 삭제할 수 있는 권한이 없습니다. |
설명
삭제 작업의 결과로 파일의 내용이 지원 원본에서 읽혀지고 전체 파일이 볼륨에 기록됩니다.
요구 사항
| 요구 사항 유형 | 요구 사항 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8.1 Update |
| 헤더 | Ntifs.h ( Ntifs.h 또는 Fltkernel.h 포함) |