CreateHardLinkTransactedA-Funktion (winbase.h)

Artikel
03/03/2024

[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 eine feste Verknüpfung zwischen einer vorhandenen Datei und einer neuen Datei als Transaktionsvorgang. Diese Funktion wird nur im NTFS-Dateisystem und nur für Dateien und nicht für Verzeichnisse unterstützt.

Syntax

BOOL CreateHardLinkTransactedA(
  [in] LPCSTR                lpFileName,
  [in] LPCSTR                lpExistingFileName,
       LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [in] HANDLE                hTransaction
);

Parameter

[in] lpFileName

Der Name der neuen Datei.

Dieser Parameter kann den Namen eines Verzeichnisses nicht angeben.

[in] lpExistingFileName

Der Name der vorhandenen Datei.

Dieser Parameter kann den Namen eines Verzeichnisses nicht angeben.

lpSecurityAttributes

Reserviert; muss NULL sein.

[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 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Die maximale Anzahl harter Links, die mit dieser Funktion erstellt werden können, beträgt 1023 pro Datei. Wenn für eine Datei mehr als 1023 Links erstellt werden, tritt ein Fehler auf.

Die Dateien müssen sich auf dem lokalen Computer befinden. Andernfalls schlägt die Funktion fehl, und der letzte Fehlercode ist auf ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE festgelegt.

Hinweise

Jeder Verzeichniseintrag für eine Datei, die mit CreateFileTransacted oder CreateHardLinkTransacted erstellt wird, ist ein harter Link zu einer zugeordneten Datei. Ein zusätzlicher harter Link, der mit der CreateHardLinkTransacted-Funktion erstellt wird, ermöglicht Es Ihnen, mehrere Verzeichniseinträge für eine Datei zu verwenden, d. h. mehrere feste Links zu derselben Datei, die unterschiedliche Namen im selben Verzeichnis oder den gleichen oder anderen Namen in verschiedenen Verzeichnissen sein können. Alle harten Links zu einer Datei müssen sich jedoch auf demselben Volume befinden.

Da feste Links nur Verzeichniseinträge für eine Datei sind, sehen alle Anwendungen, die eine andere feste Verknüpfung mit der Datei verwenden, die Änderungen, wenn eine Anwendung eine Datei über eine feste Verknüpfung ändert. Außerdem werden alle Verzeichniseinträge aktualisiert, wenn sich die Datei ändert. Wenn sich beispielsweise eine Dateigröße ändert, zeigen alle harten Links zur Datei die neue Dateigröße an.

Der Sicherheitsdeskriptor gehört zu der Datei, auf die ein harter Link verweist. Der Link selbst ist nur ein Verzeichniseintrag und verfügt nicht über einen Sicherheitsdeskriptor. Wenn Sie also den Sicherheitsdeskriptor einer harten Verknüpfung ändern, ändern Sie den Sicherheitsdeskriptor der zugrunde liegenden Datei, und alle harten Links, die auf die Datei verweisen, ermöglichen den neu angegebenen Zugriff. Sie können einer Datei nicht pro Hartlink andere Sicherheitsbeschreibungen geben.

Diese Funktion ändert den Sicherheitsdeskriptor der Zu verknüpfenden Datei nicht, auch wenn Sicherheitsdeskriptorinformationen im lpSecurityAttributes-Parameter übergeben werden.

Verwenden Sie DeleteFileTransacted , um feste Links zu löschen. Sie können sie unabhängig von der Reihenfolge, in der sie erstellt werden, in beliebiger Reihenfolge löschen.

Flags, Attribute, Zugriff und Freigabe, die in CreateFileTransacted angegeben sind, werden auf Dateibasis ausgeführt. Das heißt, wenn Sie eine Datei öffnen, die die Freigabe nicht zulässt, kann eine andere Anwendung die Datei nicht freigeben, indem sie eine neue feste Verknüpfung mit der Datei erstellt.

Wenn Sie eine feste Verknüpfung im NTFS-Dateisystem erstellen, werden die Dateiattributeinformationen im Verzeichniseintrag nur aktualisiert, wenn die Datei geöffnet wird oder wenn GetFileInformationByHandle mit dem Handle einer bestimmten Datei aufgerufen wird.

Symbolische Links: Wenn der Pfad auf eine symbolische Verknüpfung zeigt, erstellt die Funktion eine feste Verknüpfung mit dem Ziel.

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

Beachten Sie, dass SMB 3.0 TxF nicht unterstützt.

Hinweis

Der winbase.h-Header definiert CreateHardLinkTransacted 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
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll