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) |
関連項目
FltSetInformationFile の