NtSetInformationFile 関数 (ntifs.h)

NtSetInformationFile ルーチンは、ファイル オブジェクトに関するさまざまな種類の情報を変更します。

構文

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetInformationFile(
  [in]  HANDLE                 FileHandle,
  [out] PIO_STATUS_BLOCK       IoStatusBlock,
  [in]  PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

パラメーター

[in] FileHandle

ファイル オブジェクトへのハンドル。 このハンドルは、NtCreateFileまたは NtOpenFile正常に呼び出すことによって作成されます。

[out] IoStatusBlock

最終的な完了状態と要求された操作に関する情報を受け取る IO_STATUS_BLOCK 構造体へのポインター。 情報 メンバーは、ファイルに設定されたバイト数を受け取ります。

[in] FileInformation

ファイルに設定する情報を含むバッファーへのポインター。 このバッファー内の特定の構造体は、FileInformationClass パラメーターによって決定されます。 たとえば、FileInformationClass パラメーターが FileDispositionInformationEx 定数に設定されている場合、このパラメーターは FILE_DISPOSITION_INFORMATION_EX 構造体へのポインターである必要があります。

[in] Length

FileInformation バッファーのサイズ (バイト単位)。

[in] FileInformationClass

fileInformation が指すバッファーで指定された、ファイルに設定する情報の種類。 デバイス ドライバーと中間ドライバーは、次の FILE_INFORMATION_CLASS 値のいずれかを指定できます。

戻り値

NtSetInformationFile は、STATUS_SUCCESSまたは適切なエラー状態を返します。

備考

NtSetInformationFile ファイルに関する情報を変更します。 特定のデバイスまたはファイル システムでサポートされていない FILE_XXX_INFORMATION 構造体のメンバーは無視されます。

FileInformationClass を FileDispositionInformation に設定した場合は、その後、FileHandle を NtCloseをできますが、他の ZwXxxFile ルーチンには渡すことができません。 FileDispositionInformation によってファイルが削除対象としてマークされるため、ハンドルを閉じる以外の後続の操作を試行するのはプログラミング エラーです。

FileInformationClass を FilePositionInformation に設定し、前の ntCreateFile 呼び出しで CreateOptions パラメーターに FILE_NO_INTERMEDIATE_BUFFERING フラグを含める場合、FILE_POSITION_INFORMATION 構造体の CurrentByteOffset メンバーに対する特定の制限が適用されます。 詳細については、「NtCreateFile」を参照してください。

FileInformationClass を FileEndOfFileInformation に設定し、FILE_END_OF_FILE_INFORMATION の EndOfFile メンバーが現在のファイルの末尾を超えるオフセットを指定する場合は、NtSetInformationFile ファイルを拡張し、拡張子をゼロで埋め込みます。

ファイルの操作の詳細については、「ドライバー でのファイルの使用」を参照してください。

NtSetInformationFile の呼び出し元は、IRQL = PASSIVE_LEVEL で実行され、特殊なカーネル API が有効になっている 必要があります。

カーネル モード ドライバーからの呼び出しの場合、Windows ネイティブ システム サービス ルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。 ルーチンの NtXxx**** バージョンと ZwXxx**** バージョンの間の関係の詳細については、「ネイティブ システム サービス ルーチン の Nt バージョンと Zw バージョンを使用するを参照してください。

必要条件

関連項目

CreateIoCompletionPortの

FILE_BASIC_INFORMATION

FILE_COMPLETION_INFORMATION

FILE_DISPOSITION_INFORMATION

FILE_END_OF_FILE_INFORMATION

FILE_IO_PRIORITY_HINT_INFORMATION

FILE_LINK_INFORMATION

FILE_NAME_INFORMATION

FILE_POSITION_INFORMATION

FILE_RENAME_INFORMATION

FILE_VALID_DATA_LENGTH_INFORMATION

ZwClose

ZwCreateFile

ZwOpenFile

ZwQueryInformationFile