FILE_RENAME_INFORMATION構造体 (ntifs.h)

FILE_RENAME_INFORMATION構造体は、ファイルの名前を変更するために使用されます。

構文

typedef struct _FILE_RENAME_INFORMATION {
#if (_WIN32_WINNT >= _WIN32_WINNT_WIN10_RS1)
    union {
        BOOLEAN ReplaceIfExists;  // FileRenameInformation
        ULONG Flags;              // FileRenameInformationEx
    } DUMMYUNIONNAME;
#else
    BOOLEAN ReplaceIfExists;
#endif
    HANDLE RootDirectory;
    ULONG FileNameLength;
    WCHAR FileName[1];
} FILE_RENAME_INFORMATION, *PFILE_RENAME_INFORMATION;

メンバー

DUMMYUNIONNAME

DUMMYUNIONNAME.ReplaceIfExists

指定した名前のファイルが既に存在する場合は、指定したファイルに置き換える必要があることを指定するには、TRUE に設定します。 指定した名前のファイルが既に存在する場合は、名前変更操作が失敗する場合は FALSE に設定します。

DUMMYUNIONNAME.Flags

名前変更操作のフラグ。 このフィールドは、 FileRenameInformationEx 情報クラスと共に使用する場合にのみ適用されます。

可能な値を次に示します。

ReplaceIfExists

指定した名前のファイルが既に存在する場合は、指定したファイルに置き換える必要があることを指定するには、TRUE に設定します。 指定した名前のファイルが既に存在する場合は、名前変更操作が失敗する場合は FALSE に設定します。

RootDirectory

IopOpenLinkOrRenameTarget がターゲット ディレクトリを開くために使用するハンドル。

ファイルが別のディレクトリに移動されていない場合、または FileName メンバーに完全なパス名が含まれている場合、このメンバーは NULL になります。 それ以外の場合は、ファイルの名前が変更された後に存在するルート ディレクトリのハンドルです。

共有の競合を引き起こさない 2 つのオープン操作を実行するには、走査を要求して RootDirectory を 開くことができます。 |read-attribute。 IopOpenLinkOrRenameTarget は、FILE_WRITE_DATA を要求することで相対オープンを実行できます。 |同期。 これら 2 つのオープンでは、共有の競合は発生しません。

FileNameLength

ファイルの新しい名前の長さ (バイト単位)。

FileName[1]

ファイルの新しい名前を含むワイド文字列の最初の文字。 その後、メモリ内で文字列の残りの部分が続きます。 RootDirectory メンバーが NULL で、ファイルが別のディレクトリに移動されている場合、このメンバーはファイルに割り当てる完全なパス名を指定します。 それ以外の場合は、ファイル名または相対パス名のみを指定します。

注釈

FILE_RENAME_INFORMATION構造体は、ファイルの名前を変更するために使用されます。 この操作は、次のいずれかの方法で実行できます。

• FltSetInformationFile または ZwSetInformationFile を呼び出し、FileRenameInformationを FileInformationClass の値として渡し、FileInformation の値のFILE_RENAME_INFORMATION構造体として書式設定された呼び出し元によって割り当てられたバッファーを渡します。 FileHandle パラメーターは、名前を変更するファイルを指定します。

• 主要な関数コード IRP_MJ_SET_INFORMATIONを使用して IRP を作成します。

ファイル システムミニフィルターでは、ファイルの名前を変更するには、 ZwSetInformationFile ではなく FltSetInformationFile を使用する必要があります。

ファイルの名前を変更するには、ディレクトリ エントリを現在の親ディレクトリから削除できるように、ファイルへの DELETE アクセスと、新しい親ディレクトリ ファイルに新しいエントリを作成するための適切なアクセス権が必要です。

FileName メンバーのファイル名文字列は、次のいずれかの形式で指定する必要があります。

• 単純なファイル名。 ( RootDirectory メンバーは NULL です)。この場合、ファイルは単に同じディレクトリ内で名前が変更されます。 つまり、名前変更操作によってファイルの名前は変更されますが、その場所は変更されません。

• 完全修飾ファイル名。 ( RootDirectory メンバーは NULL です)。この場合、名前変更操作によってファイルの名前と場所が変更されます。

• 相対ファイル名。 この場合、 RootDirectory メンバーには、名前変更操作のターゲット ディレクトリへのハンドルが含まれます。 ファイル名自体は、単純なファイル名である必要があります。

名前変更操作の一般的な規則:

• ファイルまたはディレクトリは、ボリューム内でのみ名前を変更できます。 つまり、名前の変更操作では、ファイルまたはディレクトリを別のボリュームに移動することはできません。

• ボリュームのルート ディレクトリの名前を変更することはできません。

• ReplaceIfExists が FALSE に設定されていて、ターゲットが存在する場合、名前の変更操作は失敗します。

• ReplaceIfExists が TRUE に設定されていても、同じ名前のファイルが既に存在し、ディレクトリ、読み取り専用ファイル、または現在実行中のファイルである場合、名前変更操作は失敗します。

• ボリュームが CDFS ボリュームや読み取り専用 NTFS ボリュームなどの読み取り専用ボリュームである場合、ボリュームのファイルとディレクトリの名前を変更できません。

開いているファイルの名前を変更するための特別な規則:

• 開いているハンドルがある場合、ファイルの名前を変更することはできません。バッチの日和見ロック (oplock) が原因で開かれているだけで、バッチ oplock を直ちに壊すことができる場合を除きます。

• 同じ名前のファイルが存在し、ハンドルが開いている場合は、ファイルの名前を変更できません (前述の batch-oplock の場合を除く)。

• ディレクトリまたはそのサブディレクトリに開いているハンドルを含むファイルが含まれている場合、ディレクトリの名前を変更することはできません (前述の batch-oplock の場合を除く)。

NTFS データ ストリームの名前を変更するための特別な規則:

• 既定のディレクトリ ストリームの名前を変更することはできません。

• ストリームの新しい名前はコロン (:)で始まる必要があります。

• データ ストリームの名前は、同じファイル 内 でのみ変更できます。 つまり、名前変更操作では、データ ストリームを別のファイルに移動することはできません。

• ディレクトリ上のデータ ストリームの名前を既定のデータ ストリームに変更することはできません。

• ReplaceIfExists が TRUE に設定されている場合、名前の変更操作は、同じ名前のストリームが存在しないか、長さ 0 のデータ ストリームである場合にのみ成功します。

• 既定のデータ ストリームの "名前変更" は許可されますが、長さが 0 の既定のデータ ストリームが残るため、これは真の名前変更ではありません。

ZwSetInformationFile または FltSetInformationFile に渡される FileInformation バッファーのサイズは、 >= sizeof(FILE_RENAME_INFORMATION) と FileName 文字列のバイト単位のサイズである必要があります。

要件

こちらもご覧ください

FltSetInformationFile

IRP_MJ_SET_INFORMATION

ZwSetInformationFile