ZwSetVolumeInformationFile 함수(ntifs.h)

아티클
08/07/2023

ZwSetVolumeInformationFile 루틴은 지정된 파일, 디렉터리, 스토리지 디바이스 또는 볼륨과 연결된 볼륨에 대한 정보를 수정합니다.

구문

NTSYSAPI NTSTATUS ZwSetVolumeInformationFile(
  [in]  HANDLE               FileHandle,
  [out] PIO_STATUS_BLOCK     IoStatusBlock,
  [in]  PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

매개 변수

[in] FileHandle

볼륨 정보를 수정할 열린 파일, 디렉터리, 스토리지 디바이스 또는 볼륨에 대한 파일 개체에 대한 핸들입니다.

[out] IoStatusBlock

최종 완료 상태 받는 IO_STATUS_BLOCK 구조체 및 작업에 대한 정보를 가리키는 포인터입니다.

[in] FsInformation

수정할 볼륨 정보를 포함하는 호출자가 할당한 버퍼에 대한 포인터입니다. 이 버퍼의 정보 구조는 다음 표와 같이 FsInformationClass 값에 따라 달라집니다.

[in] Length

FsInformation이 가리키는 버퍼의 크기(바이트)입니다. 호출자는 지정된 FsInformationClass에 따라 이 매개 변수를 설정해야 합니다.

[in] FsInformationClass

설정할 볼륨 정보의 유형입니다. 다음 중 하나

값	의미
FileFsControlInformation	볼륨에 대한 FILE_FS_CONTROL_INFORMATION 설정합니다.
FileFsLabelInformation	볼륨에 대한 FILE_FS_LABEL_INFORMATION 설정합니다.
FileFsObjectIdInformation	볼륨에 대한 FILE_FS_OBJECTID_INFORMATION 설정합니다.

반환 값

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

반환 코드	설명
STATUS_INFO_LENGTH_MISMATCH	Length에 잘못된 값이 지정되었습니다. 오류 코드입니다.
STATUS_INSUFFICIENT_RESOURCES	ZwSetVolumeInformationFile 에서 풀 할당 오류가 발생했습니다. 오류 코드입니다.
STATUS_INVALID_INFO_CLASS	FsInformationClass에 잘못된 값이 지정되었습니다. 오류 코드입니다.

설명

볼륨 정보를 쿼리하려면 ZwQueryVolumeInformationFile을 호출합니다.

파일에 대한 정보를 변경하려면 ZwSetVolumeInformationFile을 호출합니다.

미니필터는 ZwSetVolumeInformationFile 대신 FltSetInformationFile을 사용해야 합니다.

참고ZwSetVolumeInformationFile함수에 대한 호출이 사용자 모드에서 발생하는 경우 "ZwSetVolumeInformationFile" 대신 "NtSetInformationFile"이라는 이름을 사용해야 합니다.

커널 모드 드라이버에서 호출하는 경우 Windows 네이티브 시스템 서비스 루틴의 NtXxx 및 ZwXxx 버전은 입력 매개 변수를 처리하고 해석하는 방식으로 다르게 동작할 수 있습니다. 루틴의 NtXxx 버전과 ZwXxx 버전 간의 관계에 대한 자세한 내용은 네이티브 시스템 서비스 루틴의 Nt 및 Zw 버전 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Server 2003
대상 플랫폼	유니버설
헤더	ntifs.h(Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)