FSCTL_GET_EXTERNAL_BACKING 제어 코드

아티클
02/12/2024

FSCTL_GET_EXTERNAL_BACKING 제어 코드는 외부 지원 공급자로부터 파일에 대한 지원 정보를 가져옵니다. 지원 공급자에는 WIM(Windows 이미지 형식) 공급자 또는 개별 압축 파일 공급자가 포함됩니다. 외부에 지원되는 파일의 콘텐츠는 쿼리된 파일이 포함된 볼륨 이외의 볼륨에 있을 수 있습니다.

이 작업을 수행하려면 다음 매개 변수 를 사용하여 FltFsControlFile 또는 ZwFsControlFile 을 호출합니다.

매개 변수

인스턴스 [in]: FltFsControlFile만 해당 합니다. 호출자에 대한 불투명 instance 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileObject [in]: FltFsControlFile만 해당 합니다. 백업 정보를 쿼리할 파일의 파일 포인터 개체입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileHandle [in]: ZwFsControlFile만 해당 합니다. 백업 정보를 쿼리할 파일의 핸들입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FsControlCode [in]: 작업에 대한 제어 코드입니다. 이 작업에 는 FSCTL_GET_EXTERNAL_BACKING 사용합니다.
InputBuffer [in]: None. 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 [out]: 성공적인 완료 시 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 구조가 포함됩니다.