FSCTL_REMOVE_OVERLAY 제어 코드
FSCTL_REMOVE_OVERLAY 제어 코드는 볼륨에서 백업 소스를 제거합니다.
이 작업을 수행하려면 다음 매개 변수를 사용하여 FltFsControlFile 또는 ZwFsControlFile 을 호출합니다.
매개 변수
인스턴스 [in]
FltFsControlFile 만 해당됩니다. 호출자에 대한 불투명 인스턴스 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileObject [in]
FltFsControlFile 만 해당됩니다. 오버레이가 제거되는 볼륨의 파일 포인터 개체입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileHandle [in]
ZwFsControlFile만 해당됩니다 . 오버레이가 제거되는 볼륨의 핸들입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FsControlCode [in]
작업에 대한 제어 코드입니다. 이 작업에 FSCTL_REMOVE_OVERLAY 사용합니다.
InputBuffer
WOF_EXTERNAL_INFO 구조를 포함해야 하는 입력 버퍼에 대한 포인터입니다. 필요한 경우 추가 공급자 관련 데이터는 WOF_EXTERNAL_INFO 직후에 포함됩니다. 공급자가 WIM 파일인 경우 WOF_EXTERNAL_INFO 후 WIM_PROVIDER_REMOVE_OVERLAY_INPUT 구조가 포함됩니다.
InputBufferLength [in]
sizeof(WOF_EXTERNAL_INFO)와 추가 공급자 입력 데이터의 크기로 설정합니다.
OutputBuffer [out]
사용되지 않습니다. NULL로 설정됨.
OutputBufferLength [in]
0으로 설정합니다.
상태 블록
작업이 성공하면 FltFsControlFile 또는 ZwFsControlFile이 STATUS_SUCCESS 반환합니다. 그렇지 않으면 적절한 함수가 다음 NTSTATUS 값 중 하나를 반환할 수 있습니다.
| 용어 | Description |
|---|---|
STATUS_ACCESS_DENIED |
요청자에게 관리 권한이 없습니다. |
STATUS_BUFFER_TOO_SMALL |
OutputBuffer에서 가리키고 OutputBufferLength로 지정된 출력 버퍼의 길이가 너무 작습니다. |
STATUS_INTERNAL_ERROR |
요청된 볼륨에 액세스할 수 없습니다. |
STATUS_INVALID_DEVICE_REQUEST |
지원 서비스가 없거나 시작되지 않았습니다. |
설명
제거할 백업 원본이 WIM(Windows 이미징 형식) 파일인 경우 입력 버퍼에는 WOF_EXTERNAL_INFO 구조와 WIM_PROVIDER_REMOVE_OVERLAY_INPUT 구조가 포함됩니다. 이 경우 InputBufferLength 는 sizeof(WOF_EXTERNAL_INFO) + sizeof(WIM_PROVIDER_REMOVE_OVERLAY_INPUT)입니다. WIM_PROVIDER_REMOVE_OVERLAY_INPUTDataSourceId 값은 이전에 FSCTL_ADD_OVERLAY 요청에 추가된 WIM 파일에 대한 값이어야 합니다.
추가 지원 공급자는 고유한 특정 입력 매개 변수 구조를 정의합니다.
요구 사항
Version |
Windows 8.1 Update 시작해서 사용할 수 있습니다. |
헤더 |
Ntifs.h(Ntifs.h 또는 Fltkernel.h 포함) |