Fungsi CreateSymbolicLinkTransactedA (winbase.h)

Artikel
08/27/2023

[Microsoft sangat menyarankan pengembang menggunakan cara alternatif untuk mencapai kebutuhan aplikasi Anda. Banyak skenario yang dikembangkan TxF dapat dicapai melalui teknik yang lebih sederhana dan lebih tersedia. Selain itu, TxF mungkin tidak tersedia di versi Microsoft Windows yang akan datang. Untuk informasi lebih lanjut, dan alternatif TxF, silakan lihat Alternatif untuk menggunakan Transactional NTFS.]

Membuat tautan simbolis sebagai operasi yang ditransaksikan.

Sintaks

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

Parameter

[in] lpSymlinkFileName

Tautan simbolis yang akan dibuat.

[in] lpTargetFileName

Nama target untuk tautan simbolis yang akan dibuat.

Jika lpTargetFileName memiliki nama perangkat yang terkait dengannya, tautan diperlakukan sebagai tautan absolut; jika tidak, tautan diperlakukan sebagai tautan relatif.

[in] dwFlags

Menunjukkan apakah target tautan, lpTargetFileName, adalah direktori.

Nilai	Makna
0x0	Target tautan adalah file.
SYMBOLIC_LINK_FLAG_DIRECTORY 0x1	Target tautan adalah direktori.

[in] hTransaction

Handel ke transaksi. Handel ini dikembalikan oleh fungsi CreateTransaction .

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Tautan simbolis dapat berupa tautan absolut atau relatif. Tautan absolut adalah tautan yang menentukan setiap bagian dari nama jalur; tautan relatif ditentukan relatif terhadap di mana penentu tautan relatif berada di jalur tertentu. Tautan relatif ditentukan menggunakan konvensi berikut:

Konvensi titik (. dan ..)—misalnya, ".. \" menyelesaikan jalur yang relatif terhadap direktori induk.
Nama tanpa garis miring (\\)—misalnya, "tmp" menyelesaikan jalur yang relatif terhadap direktori saat ini.
Root relative—misalnya, "\Windows\System32" menyelesaikan ke "drive saat ini:\Windows\System32".
Direktori kerja saat ini–relatif—misalnya, jika direktori kerja saat ini adalah C:\Windows\System32, "C:File.txt" diselesaikan ke "C:\Windows\System32\File.txt".
Catatan Jika Anda menentukan tautan relatif direktori kerja saat ini, tautan tersebut dibuat sebagai tautan absolut, karena cara direktori kerja saat ini diproses berdasarkan pengguna dan utas.

Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.

Teknologi	Didukung
Protokol Server Message Block (SMB) 3.0	Tidak
SMB 3.0 Transparent Failover (TFO)	Tidak
SMB 3.0 dengan Scale-out File Shares (SO)	Tidak
Sistem File Volume Bersama Kluster (CsvFS)	Tidak
Sistem File Tangguh (ReFS)	Tidak

SMB 3.0 tidak mendukung TxF.

Catatan

Header winbase.h mendefinisikan CreateSymbolicLinkTransacted sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

Fungsi Manajemen File

Tautan Simbolis

NTFS Transaksi

Bagikan melalui