ZwSetVolumeInformationFile 함수(ntifs.h)
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 값을 반환합니다.
반환 코드 | 설명 |
---|---|
|
Length에 잘못된 값이 지정되었습니다. 오류 코드입니다. |
|
ZwSetVolumeInformationFile 에서 풀 할당 오류가 발생했습니다. 오류 코드입니다. |
|
FsInformationClass에 잘못된 값이 지정되었습니다. 오류 코드입니다. |
설명
볼륨 정보를 쿼리하려면 ZwQueryVolumeInformationFile을 호출합니다.
파일에 대한 정보를 변경하려면 ZwSetVolumeInformationFile을 호출합니다.
미니필터는 ZwSetVolumeInformationFile 대신 FltSetInformationFile을 사용해야 합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Server 2003 |
대상 플랫폼 | 유니버설 |
헤더 | ntifs.h(Ntifs.h 포함) |
라이브러리 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 규정 준수 규칙 | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |