CreateSymbolicLinkTransactedW, fonction (winbase.h)

[Microsoft recommande vivement aux développeurs d’utiliser d’autres moyens pour répondre aux besoins de votre application. De nombreux scénarios utilisant TxF peuvent être réalisés à l’aide de techniques plus simples et plus facilement disponibles. En outre, TxF peut ne pas être disponible dans les versions à venir de Microsoft Windows. Pour plus d’informations et les alternatives à TxF, consultez Alternatives à l’utilisation de Transactionnel NTFS.]

Crée un lien symbolique en tant qu’opération transactionnelle.

Syntaxe

BOOLEAN CreateSymbolicLinkTransactedW(
  [in] LPCWSTR lpSymlinkFileName,
  [in] LPCWSTR lpTargetFileName,
  [in] DWORD   dwFlags,
  [in] HANDLE  hTransaction
);

Paramètres

[in] lpSymlinkFileName

Lien symbolique à créer.

[in] lpTargetFileName

Nom de la cible pour le lien symbolique à créer.

Si lpTargetFileName a un nom d’appareil associé, le lien est traité comme un lien absolu ; sinon, le lien est traité comme un lien relatif.

[in] dwFlags

Indique si la cible de lien, lpTargetFileName, est un répertoire.

Valeur	Signification
0x0	La cible de lien est un fichier.
SYMBOLIC_LINK_FLAG_DIRECTORY 0x1	La cible de lien est un répertoire.

[in] hTransaction

Handle de la transaction. Ce handle est retourné par la fonction CreateTransaction .

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Les liens symboliques peuvent être des liens absolus ou relatifs. Les liens absolus sont des liens qui spécifient chaque partie du nom du chemin ; les liens relatifs sont déterminés par rapport à l’emplacement où les spécificateurs de lien relatif se trouvent dans un chemin spécifié. Les liens relatifs sont spécifiés à l’aide des conventions suivantes :

• Conventions de point (. et ..). Par exemple, « ..\ » résout le chemin par rapport au répertoire parent.
• Noms sans barres obliques (\\) : par exemple, « tmp » résout le chemin d’accès relatif au répertoire actif.
• Relative racine, par exemple, « \Windows\System32 » est résolu en « lecteur actuel :\Windows\System32 ».
• Répertoire de travail actuel relatif. Par exemple, si le répertoire de travail actuel est C :\Windows\System32, « C:File.txt » est résolu en « C:\Windows\System32\File.txt ».
  Remarque Si vous spécifiez un lien par rapport au répertoire de travail actuel, il est créé en tant que lien absolu, en raison de la façon dont le répertoire de travail actuel est traité en fonction de l’utilisateur et du thread.
   

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technologie	Prise en charge
Protocole Server Message Block (SMB) 3.0	No
Basculement transparent SMB 3.0 (TFO)	No
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	No
Système de fichiers du volume partagé de cluster (CsvFS)	No
Système de fichiers résilient (ReFS)	No

 

SMB 3.0 ne prend pas en charge TxF.

Notes

L’en-tête winbase.h définit CreateSymbolicLinkTransacted en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

Fonctions de gestion des fichiers

Liens symboliques

NTFS transactionnel