다음을 통해 공유


FSCTL_SET_PERSISTENT_VOLUME_STATE 제어 코드

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

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

매개 변수

  • FileObject [in]: FltFsControlFile만 해당 합니다. 파일 시스템 볼륨에 대한 파일 개체 포인터입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

  • FileHandle [in]: ZwFsControlFile만 해당 합니다. 파일 시스템 볼륨에 대한 파일 핸들입니다. 이 매개 변수는 필수이며 NULL일 수 없습니다.

  • FsControlCode [in]: 작업에 대한 제어 코드입니다. 이 작업에 는 FSCTL_SET_PERSISTENT_VOLUME_STATE 사용합니다.

  • InputBuffer [in]: 파일 시스템 볼륨에 대한 영구 설정을 포함하는 호출자가 할당한 FILE_FS_PERSISTENT_VOLUME_INFORMATION 구조체에 대한 포인터입니다.

  • InputBufferLength [in]: InputBuffer 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.

  • OutputBuffer [out]: 이 작업에 사용되지 않습니다. 을 NULL로 설정합니다.

  • OutputBufferLength [out]: 이 작업에 사용되지 않습니다. 를 0으로 설정합니다.

상태 블록

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 매개 변수가 가리키는 버퍼는 영구 설정 데이터를 저장할 만큼 크지 않습니다. 이 경우 영구 설정 데이터가 설정되지 않습니다. 오류 코드입니다.
STATUS_ACCESS_DENIED 호출자가 파일 시스템 볼륨에 액세스할 수 없습니다.
STATUS_VOLUME_DISMOUNTED 파일 시스템 볼륨이 분리됩니다.
STATUS_TOO_LATE 파일 시스템 볼륨이 종료됩니다.
STATUS_MEDIA_WRITE_PROTECTED 파일 시스템 볼륨은 읽기 전용입니다.

요구 사항

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

추가 정보

FILE_FS_PERSISTENT_VOLUME_INFORMATION

FltFsControlFile

ZwFsControlFile