CreateSymbolicLinkTransactedA-Funktion (winbase.h)

  • Artikel

[Microsoft empfiehlt Entwicklern dringend, alternative Mittel zu verwenden, um die Anforderungen Ihrer Anwendung zu erfüllen. Viele Szenarios, für die TxF entwickelt wurde, können mit einfacheren und leichter verfügbaren Techniken erreicht werden. Darüber hinaus ist TxF in zukünftigen Versionen von Microsoft Windows möglicherweise nicht verfügbar. Weitere Informationen und Alternativen zu TxF finden Sie unter Alternativen zur Verwendung von transaktionalem NTFS.]

Erstellt einen symbolischen Link als Transaktionsvorgang.

Syntax

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

Parameter

[in] lpSymlinkFileName

Der zu erstellende symbolische Link.

[in] lpTargetFileName

Der Name des Ziels für den zu erstellenden symbolischen Link.

Wenn lpTargetFileName über einen Gerätenamen verfügt, wird der Link als absoluter Link behandelt. andernfalls wird der Link als relativer Link behandelt.

[in] dwFlags

Gibt an, ob das Linkziel lpTargetFileName ein Verzeichnis ist.

Wert Bedeutung
0x0
 Das Linkziel ist eine Datei.
SYMBOLIC_LINK_FLAG_DIRECTORY
0x1
 Das Linkziel ist ein Verzeichnis.

[in] hTransaction

Ein Handle für die Transaktion. Dieses Handle wird von der CreateTransaction-Funktion zurückgegeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Symbolische Verknüpfungen können entweder absolute oder relative Links sein. Absolute Links sind Links, die jeden Teil des Pfadnamens angeben. relative Links werden relativ zu dem Wert bestimmt, an dem sich relative Link-Bezeichner in einem angegebenen Pfad befinden. Relative Links werden mithilfe der folgenden Konventionen angegeben:

  • Punktkonventionen (. und ..) – z. B. ".. \" lösen den Pfad relativ zum übergeordneten Verzeichnis auf.
  • Namen ohne Schrägstriche (\\) – beispielsweise löst "tmp" den Pfad relativ zum aktuellen Verzeichnis auf.
  • Stammrelativ– z. B. "\Windows\System32" wird in "current drive:\Windows\System32" aufgelöst.
  • Aktuelles Arbeitsverzeichnis – relativ: Wenn das aktuelle Arbeitsverzeichnis beispielsweise C:\Windows\System32 ist, wird "C:File.txt" in "C:\Windows\System32\File.txt" aufgelöst.
    Hinweis Wenn Sie einen relativen Link für ein aktuelles Arbeitsverzeichnis angeben, wird dieser als absoluter Link erstellt, da das aktuelle Arbeitsverzeichnis basierend auf dem Benutzer und dem Thread verarbeitet wird.
     
Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.
Technologie Unterstützt
SMB 3.0-Protokoll (Server Message Block) No
SMB 3.0 Transparent Failover (TFO) No
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) No
Dateisystem mit freigegebenen Clustervolumes (CsvFS) No
Robustes Dateisystem (Resilient File System, ReFS) No
 

SMB 3.0 unterstützt TxF nicht.

Hinweis

Der winbase.h-Header definiert CreateSymbolicLinkTransacted als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbase.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Dateiverwaltungsfunktionen

Symbolische Links

Transaktions-NTFS