CreateSymbolicLinkTransactedA-Funktion (winbase.h)
[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 |
|---|---|
|
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 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.
| 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 |