次の方法で共有

FSCTL_QUERY_FILE_REGIONS IOCTL (ntifs.h)

  • [アーティクル]

FSCTL_QUERY_FILE_REGIONS 、この FSCTL が呼び出されたハンドルに関連付けられているファイルについて、指定した使用法パラメーターに基づいてファイル領域の一覧を照会します。 このメッセージには、省略可能なFILE_REGION_INPUTデータ要素 が 含まれています。 FILE_REGION_INPUT パラメーターが指定されていない場合は、ファイルのサイズ全体に関する情報が返されます。

メジャー コード

FSCTL_QUERY_FILE_REGIONS

[入力バッファー]

クエリを実行するファイル領域を示す FILE_REGION_INPUT 構造体へのポインター。

入力バッファーの長さ

InputBuffer が指すFILE_REGION_INPUT構造体のサイズ (バイト単位)。

出力バッファー

クエリの結果が返される FILE_REGION_OUTPUT 構造体へのポインター。

出力バッファーの長さ

OutputBuffer が指すバッファーのサイズ (バイト単位)。

入力/出力バッファー

該当なし

入力/出力バッファーの長さ

該当なし

ステータス ブロック

システムで使用するために予約されています。

注釈

この操作を実行するには、次のパラメーターを指定して FltFsControlFile または ZwFsControlFile を呼び出します。

パラメーター 説明
インスタンス [入力] FltFsControlFile の場合のみ。 呼び出し元の不透明なインスタンス ポインター。 このパラメーターは必須であり、NULL にすることはできません。
FileObject [入力] FltFsControlFile の場合のみ。 この要求のターゲットであるファイルまたはディレクトリのファイル オブジェクト ポインター。 このパラメーターは必須であり、NULL にすることはできません。
FileHandle [入力] ZwFsControlFile の場合のみ。 この要求のターゲットであるファイルまたはディレクトリのファイル ハンドル。 このパラメーターは必須であり、NULL にすることはできません。
IoStatusBlock [out] ZwFsControlFile の場合のみ。 要求の最終状態が返される IO_STATUS_BLOCK 構造体へのポインター。
FsControlCode [入力] FSCTL_QUERY_FILE_REGIONSに設定します。
InputBuffer [入力/省略可能]クエリを実行するファイル領域を示す FILE_REGION_INPUT 構造体へのポインター。
InputBufferLength [入力] InputBuffer が指すバッファーのサイズ (バイト単位)。
OutputBuffer [out]クエリの結果が返される FILE_REGION_OUTPUT 構造体へのポインター。
OutputBufferLength [out] OutputBuffer が指すバッファーのサイズ (バイト単位)。
LengthReturned [out] OutputBuffer でバッファーに返される情報のサイズ (バイト単位) を受け取る呼び出し元割り当て変数へのポインター。

戻り値

FSCTL_QUERY_FILE_REGIONSは 、正常に完了するとSTATUS_SUCCESSを返します。それ以外の場合は、エラー コードを返します。 正常に完了すると、呼び出し元は、OutputBuffer で返される情報にアクセスする前に、IoStatus.Information が LengthReturned 以上であることを最初に確認する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 8
Header ntifs.h

こちらもご覧ください

FILE_REGION_INPUT

FILE_REGION_OUTPUT

FltFsControlFile

ZwFsControlFile