FltSetVolumeInformation 函式（fltkernel.h）

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 值，例如下列其中一項：

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