ZwSetVolumeInformationFile 函式（ntifs.h）

發行項
12/21/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。

Minifilters 應該使用 FltSetInformationFile，而不是 ZwSetVolumeInformationFile。

注意如果在使用者模式中呼叫 ZwSetVolumeInformationFile函式，您應該使用名稱 “NtSetInformationFile”，而不是 “ZwSetVolumeInformationFile”。

對於內核模式驅動程式的呼叫，NtXxx 和 ZwXxx 版本的 Windows 原生系統服務例程，在處理和解譯輸入參數的方式上可能會有不同的行為。如需 nt NtXxx 與 ZwXxx 例程之間關聯性的詳細資訊，請參閱使用 Nt 和 Zw 版本的原生系統服務例程。

要求

要求	價值
最低支援的用戶端	Windows Server 2003
目標平臺	普遍
標頭	ntifs.h （include Ntifs.h）
連結庫	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 合規性規則	HwStorPortProhibitedDIs（storport），PowerIrpDDis（wdm）