CreateSymbolicLinkTransactedA-Funktion (winbase.h)
[Microsoft empfiehlt Entwicklern dringend, alternative Mittel zu nutzen, um die Anforderungen Ihrer Anwendung zu erreichen. Viele Szenarien, für die TxF entwickelt wurde, können durch einfachere und leichter verfügbare 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 Transactional NTFS.]
Erstellt eine symbolische Verknüpfung als Transaktionsvorgang.
Syntax
BOOLEAN CreateSymbolicLinkTransactedA(
[in] LPCSTR lpSymlinkFileName,
[in] LPCSTR lpTargetFileName,
[in] DWORD dwFlags,
[in] HANDLE hTransaction
);
Parameter
[in] lpSymlinkFileName
Die zu erstellende symbolische Verknüpfung.
[in] lpTargetFileName
Der Name des Ziels für die zu erstellende symbolische Verknüpfung.
Wenn lpTargetFileName einem Gerätenamen zugeordnet ist, wird der Link als absoluter Link behandelt. andernfalls wird der Link als relative Verknüpfung behandelt.
[in] dwFlags
Gibt an, ob das Linkziel lpTargetFileNameein Verzeichnis ist.
| Wert | Bedeutung |
|---|---|
|
Das Linkziel ist eine Datei. |
|
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 fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Symbolische Verknüpfungen können entweder absolute oder relative Verknüpfungen sein. Absolute Verknüpfungen sind Links, die jeden Teil des Pfadnamens angeben. Relative Verknüpfungen werden relativ dazu bestimmt, wo sich relative Verknüpfungsbezeichner in einem angegebenen Pfad befinden. Relative Links werden mithilfe der folgenden Konventionen angegeben:
- Dot(- und ..)-Konventionen , z. B. ".. \" löst den Pfad relativ zum übergeordneten Verzeichnis auf.
- Namen ohne Schrägstriche (\\), z. B. löst "tmp" den Pfad relativ zum aktuellen Verzeichnis auf.
- Stammrelativ – z. B. "\Windows\System32" wird in "aktuelles Laufwerk:\Windows\System32" aufgelöst.
- Aktuelles Arbeitsverzeichnis –relativ , z. B. wenn das aktuelle Arbeitsverzeichnis "C:\Windows\System32" lautet, wird "C:File.txt" in "C:\Windows\System32\File.txt" aufgelöst.
Hinweis Wenn Sie einen relativen Arbeitsverzeichnisverknüpfung angeben, wird sie aufgrund der Art und Weise erstellt, wie das aktuelle Arbeitsverzeichnis basierend auf dem Benutzer und dem Thread verarbeitet wird.
| Technologie | Abgestützt |
|---|---|
| Server Message Block (SMB) 3.0-Protokoll | Nein |
| SMB 3.0 Transparent Failover (TFO) | Nein |
| SMB 3.0 mit Skalierungsdateifreigaben (SO) | Nein |
| Freigegebenes Clustervolumedateisystem (CsvFS) | Nein |
| Resilient File System (ReFS) | Nein |
SMB 3.0 unterstützt TxF nicht.
Anmerkung
Der winbase.h-Header definiert CreateSymbolicLinkTransacted als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |