CreateSymbolicLinkTransactedA 関数 (winbase.h)

[Microsoft では、開発者がアプリケーションのニーズを達成するために代替手段を利用することを強くお勧めします。 TxF が開発された多くのシナリオは、よりシンプルで簡単に利用できる手法によって実現できます。 さらに、将来のバージョンの Microsoft Windows では TxF を使用できない可能性があります。 詳細と TxF の代替方法については、「トランザクション NTFSを使用する の代替方法」を参照してください。

シンボリック リンクをトランザクション操作として作成します。

構文

BOOLEAN CreateSymbolicLinkTransactedA(
  [in] LPCSTR lpSymlinkFileName,
  [in] LPCSTR lpTargetFileName,
  [in] DWORD  dwFlags,
  [in] HANDLE hTransaction
);

パラメーター

[in] lpSymlinkFileName

作成するシンボリック リンク。

[in] lpTargetFileName

作成するシンボリック リンクのターゲットの名前。

lpTargetFileName デバイス名が関連付けられている場合、リンクは絶対リンクとして扱われます。それ以外の場合、リンクは相対リンクとして扱われます。

[in] dwFlags

リンク ターゲット (lpTargetFileName) がディレクトリであるかどうかを示します。

[in] hTransaction

トランザクションのハンドル。 このハンドルは、CreateTransaction 関数によって返されます。

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

シンボリック リンクには、絶対リンクまたは相対リンクを指定できます。 絶対リンクは、パス名の各部分を指定するリンクです。相対リンクは、相対リンク指定子が指定されたパス内のどこにあるかを基準にして決定されます。 相対リンクは、次の規則を使用して指定します。

• ドット (. および ..) の規則 (例: "..\" は、親ディレクトリに対する相対パスを解決します。
• スラッシュ (\\) を持たない名前 (たとえば、"tmp" は、現在のディレクトリを基準にしたパスを解決します。
• ルート相対 -たとえば、"\Windows\System32" は "現在のドライブ:\Windows\System32" に解決されます。
• 現在の作業ディレクトリの相対ディレクトリ。たとえば、現在の作業ディレクトリが C:\Windows\System32 の場合、"C:File.txt" は "C:\Windows\System32\File.txt" に解決されます。
  注 現在の作業ディレクトリの相対リンクを指定すると、ユーザーとスレッドに基づいて現在の作業ディレクトリが処理されるため、絶対リンクとして作成されます。
   

SMB 3.0 は TxF をサポートしていません。

必要条件

関連項目

ファイル管理機能の

シンボリック リンク の

トランザクション NTFS の