FltSetVolumeInformation 函式 (fltkernel.h)

發行項
02/26/2024

FltSetVolumeInformation 會變更指定實例所附加磁碟區的各種資訊。

語法

NTSTATUS FLTAPI FltSetVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

參數

[in] Instance

附加至磁碟區之迷你篩選驅動程序實例的不透明實例指標。

[out] Iosb

接收最終完成狀態和作業相關信息之IO_STATUS_BLOCK結構的指標。

[out] FsInformation

呼叫端配置的緩衝區指標，其中包含要為磁碟區設定的值。緩衝區中包含的信息結構是由 FsInformationClass 參數所定義。

[in] Length

FsInformation 所指向緩衝區的位元元組大小。呼叫端應該根據指定的 FsInformationClass 來設定此參數。例如，如果 FsInformationClass 的值是 FileFsControlInformation，Length 必須是至少 sizeof ( FILE_FS_CONTROL_INFORMATION) 。

[in] FsInformationClass

要為磁碟區設定的信息類型。下列其中一項。

值	意義
FileFsControlInformation	設定磁碟區的FILE_FS_CONTROL_INFORMATION 。
FileFsLabelInformation	設定磁碟區的FILE_FS_LABEL_INFORMATION 。
FileFsObjectIdInformation	設定磁碟區的FILE_FS_OBJECTID_INFORMATION 。

傳回值

FltSetVolumeInformation 會 傳回STATUS_SUCCESS或適當的 NTSTATUS 值，例如下列其中一項：

傳回碼	Description
STATUS_INFO_LENGTH_MISMATCH	為 Length 指定了無效的值。這是錯誤碼。
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation 發生集區配置失敗。這是錯誤碼。
STATUS_INVALID_INFO_CLASS	為 FsInformationClass 指定了無效的值。這是錯誤碼。
STATUS_INVALID_PARAMETER	實例會連結至網路磁碟區。 FltSetVolumeInformation 無法用來設定網路磁碟區資訊。這是錯誤碼。