CreateHardLinkW

既存ファイルと新しいファイルの間にハードリンクを確立する。(Unicode)

CreateHardLinkW lpFileName, lpExistingFileName, lpSecurityAttributes

lpFileName : [wstr] 新しいファイルの名前。
lpExistingFileName : [wstr] 既存ファイルの名前。
lpSecurityAttributes : [var] 予約済み。NULL でなければならない。

(プラグイン / モジュール : kernel32.dll)

解説

既存ファイルと新しいファイルの間にハードリンクを確立する。(Unicode)

[戻り値]
関数が成功した場合、戻り値はゼロ以外。関数が失敗した場合、戻り値はゼロ (0)。拡張エラー情報を取得するには GetLastError
を呼ぶ。この関数で作成できるハードリンクの最大数は 1 ファイルあたり 1023 個。1 ファイルに対して 1023
を超えるリンクを作成しようとするとエラーになる。この関数の ANSI 版または "\\\\?\\" を前置しない Unicode 版の
*lpFileName* または *lpExistingFileName* パラメータに MAX_PATH
文字より長い名前を渡すと、関数は ERROR_PATH_NOT_FOUND を返す。

[備考]
CreateFile または CreateHardLink
で作成されたファイルのディレクトリエントリは、関連付けられたファイルへのハードリンクである。CreateHardLink
関数で作成される追加のハードリンクを使うと、ファイルに対して複数のディレクトリエントリ、つまり同一ファイルへの複数のハードリンクを持つことができる。同じディレクトリ内で異なる名前でもよく、異なるディレクトリで同じ名前または異なる名前でもよい。ただし、ファイルへのすべてのハードリンクは同じボリューム上に存在しなければならない。ハードリンクはファイルに対するディレクトリエントリにすぎないため、そのファイルに対する多くの変更は、それを参照するハードリンクを通じてアクセスするアプリケーションに即座に可視になる。ただし、ディレクトリエントリのサイズと属性情報は、変更が行われたリンクについてのみ更新される。セキュリティ記述子はハードリンクが指すファイルに属する。リンク自体はディレクトリエントリにすぎず、セキュリティ記述子を持たない。したがって、ハードリンクのセキュリティ記述子を変更すると、基盤となるファイルのセキュリティ記述子を変更することになり、そのファイルを指すすべてのハードリンクが新たに指定されたアクセスを許可するようになる。ハードリンクごとに異なるセキュリティ記述子をファイルに与えることはできない。この関数は、lpSecurityAttributes
パラメータにセキュリティ記述子情報が渡された場合でも、リンク対象ファイルのセキュリティ記述子を変更しない。ハードリンクを削除するには
DeleteFile を使う。作成した順序に関わらず、任意の順序で削除できる。CreateFile
で指定されたフラグ、属性、アクセス、共有はファイル単位で動作する。つまり、共有を許可しないファイルを開いた場合、別のアプリケーションは新しいハードリンクを作成してもそのファイルを共有できない。NTFS
ファイルシステム上でハードリンクを作成するとき、ディレクトリエントリのファイル属性情報は、ファイルが開かれるときまたは特定のファイルのハンドルを指定して
GetFileInformationByHandle が呼ばれるときにのみ更新される。シンボリックリンクの動作 ?
パスがシンボリックリンクを指す場合、関数はシンボリックリンクへのハードリンクを作成する。Windows 8 および Windows
Server 2012 では、この関数は以下の技術でサポートされている。
（以下省略）

情報