ZwSetVolumeInformationFile 함수(ntifs.h)

아티클
12/22/2024

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 ""을 사용해야 합니다.

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

요구 사항

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