FSCTL_QUERY_PERSISTENT_VOLUME_STATE 制御コード
FSCTL_QUERY_PERSISTENT_VOLUME_STATE 制御コードは、ファイル システム ボリュームの永続設定を取得します。 永続設定はコンピューターを再起動してもファイル システム ボリュームに残ります。
この操作を実行するには、次のパラメーターを指定して FltFsControlFile または ZwFsControlFile を呼び出します。
パラメーター
FileObject [in]: FltFsControlFile のみ。 ファイル システム ボリュームのファイル オブジェクト ポインター。 このパラメーターは必須であり、NULL にすることはできません。
FileHandle [in]: ZwFsControlFile のみ。 ファイル システム ボリュームのファイル ハンドル。 このパラメーターは必須であり、NULL にすることはできません。
FsControlCode [in]: 操作の制御コード。 この操作には FSCTL_QUERY_PERSISTENT_VOLUME_STATE を使用します。
InputBuffer [in]: 呼び出し元によって割り当てられた FILE_FS_PERSISTENT_VOLUME_INFORMATION 構造体へのポインター。
InputBufferLength [in]: InputBuffer パラメーターが指し示すバッファーのサイズ (バイト単位)。
OutputBuffer [out]: ファイル システム ボリュームの永続設定を受け取る、呼び出し元によって割り当てられた FILE_FS_PERSISTENT_VOLUME_INFORMATION 構造体へのポインター。
OutputBufferLength [out]: OutputBuffer パラメーターが指し示すバッファーのサイズ (バイト単位)。
ステータスブロック
FltFsControlFile または ZwFsControlFile は、STATUS_SUCCESS または次のいずれかの適切な NTSTATUS 値を返します。
| コード | 意味 |
|---|---|
| STATUS_NOT_SUPPORTED | 呼び出し元が、FILE_FS_PERSISTENT_VOLUME_INFORMATION の Version メンバーに正しくないバージョンを指定しました。 |
| STATUS_INVALID_PARAMETER | ファイル システム ボリュームが開いているユーザー ボリュームではないか、呼び出し元が FILE_FS_PERSISTENT_VOLUME_INFORMATION の FlagMask メンバーに無効なフラグを指定しました。 |
| STATUS_BUFFER_TOO_SMALL | InputBuffer パラメーターが指し示すバッファーの大きさが十分ではありません (つまりバッファーが sizeof(FILE_FS_PERSISTENT_VOLUME_INFORMATION) 未満です)。 この場合、永続設定データは返されません。 これはエラー コードです。 |
| STATUS_ACCESS_DENIED | 呼び出し元がファイル システム ボリュームにアクセスできません。 |
| STATUS_VOLUME_DISMOUNTED | ファイル システム ボリュームがマウント解除されています。 |
| STATUS_TOO_LATE | ファイル システム ボリュームがシャットダウンされています。 |
| STATUS_MEDIA_WRITE_PROTECTED | ファイル システム ボリュームは読み取り専用です。 |
要件
| 要件タイプ | 要件 |
|---|---|
| サポートされている最小のクライアント | Windows 7 |
| ヘッダー | Ntifs.h (Ntifs.h または Fltkernel.h を含む) |