FSCTL_QUERY_PERSISTENT_VOLUME_STATE 제어 코드

FSCTL_QUERY_PERSISTENT_VOLUME_STATE 제어 코드는 파일 시스템 볼륨에 대한 영구 설정을 검색합니다. 영구 설정은 컴퓨터를 다시 부팅하는 동안 파일 시스템 볼륨에 유지됩니다.

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

매개 변수

FileObject [in]: FltFsControlFile만 해당 합니다. 파일 시스템 볼륨에 대한 파일 개체 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FileHandle [in]: ZwFsControlFile만 해당 합니다. 파일 시스템 볼륨에 대한 파일 핸들입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.
FsControlCode [in]: 작업에 대한 제어 코드입니다. 이 작업에 는 FSCTL_QUERY_PERSISTENT_VOLUME_STATE 사용합니다.
InputBuffer [in]: 호출자가 할당한 FILE_FS_PERSISTENT_VOLUME_INFORMATION 구조체에 대한 포인터입니다.
InputBufferLength [in]: InputBuffer 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.
OutputBuffer [out]: 파일 시스템 볼륨에 대한 영구 설정을 수신하는 호출자가 할당한 FILE_FS_PERSISTENT_VOLUME_INFORMATION 구조체에 대한 포인터입니다.
OutputBufferLength [out]: OutputBuffer 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.

FltFsControlFile 또는 ZwFsControlFile 은 STATUS_SUCCESS 또는 다음 중 하나와 같은 적절한 NTSTATUS 값을 반환합니다.

코드	의미
STATUS_NOT_SUPPORTED	호출자가 FILE_FS_PERSISTENT_VOLUME_INFORMATION버전 멤버에 잘못된 버전 번호를 지정했습니다.
STATUS_INVALID_PARAMETER	파일 시스템 볼륨이 열려 있는 사용자 볼륨이 아니거나 호출자가 FILE_FS_PERSISTENT_VOLUME_INFORMATIONFlagMask 멤버에 잘못된 플래그를 지정했습니다.
STATUS_BUFFER_TOO_SMALL	InputBuffer 매개 변수가 가리키는 버퍼가 충분히 크지 않습니다(즉, 버퍼가 sizeof(FILE_FS_PERSISTENT_VOLUME_INFORMATION)보다 작음). 이 경우 영구 설정 데이터가 반환되지 않습니다. 오류 코드입니다.
STATUS_ACCESS_DENIED	호출자가 파일 시스템 볼륨에 액세스할 수 없습니다.
STATUS_VOLUME_DISMOUNTED	파일 시스템 볼륨이 분리됩니다.
STATUS_TOO_LATE	파일 시스템 볼륨이 종료됩니다.
STATUS_MEDIA_WRITE_PROTECTED	파일 시스템 볼륨은 읽기 전용입니다.

요구 사항 유형	요구 사항
지원되는 최소 클라이언트	Windows 7
헤더	Ntifs.h ( Ntifs.h 또는 Fltkernel.h 포함)