GetLongPathNameTransactedW, 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.]
Convertit le chemin d’accès spécifié en sa forme longue en tant qu’opération transactionnelle.
Pour effectuer cette opération sans transaction, utilisez la fonction GetLongPathName .
Pour plus d’informations sur les noms de fichiers et de chemins d’accès, consultez Naming Files, Paths, and Namespaces.
Syntaxe
DWORD GetLongPathNameTransactedW(
[in] LPCWSTR lpszShortPath,
[out] LPWSTR lpszLongPath,
[in] DWORD cchBuffer,
[in] HANDLE hTransaction
);
Paramètres
[in] lpszShortPath
Chemin d’accès à convertir.
Le chemin d’accès doit résider sur l’ordinateur local ; sinon, la fonction échoue et le dernier code d’erreur est défini sur ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE.
Par défaut, le nom est limité à MAX_PATH caractères. Pour étendre cette limite à 32 767 caractères de large, ajoutez « \\ ?\ » au chemin d’accès. Pour plus d’informations, consultez Nommage de fichiers, de chemins et d’espaces de noms.
Conseil
À compter de Windows 10, version 1607, vous pouvez choisir de supprimer la limitation de MAX_PATH sans précédencer « \ ?\ ». Pour plus d’informations, consultez la section « Limitation de longueur maximale du chemin d’accès » dans Naming Files, Paths et Namespaces .
[out] lpszLongPath
Pointeur vers la mémoire tampon pour recevoir le chemin long.
Vous pouvez utiliser la même mémoire tampon que celle que vous avez utilisée pour le paramètre lpszShortPath .
[in] cchBuffer
La taille de la mémoire tampon lpszLongPath pointe vers, dans les TCHAR.
[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 la longueur, en TCHARs, de la chaîne copiée dans lpszLongPath, sans inclure le caractère null de fin.
Si la mémoire tampon lpBuffer est trop petite pour contenir le chemin d’accès, la valeur de retour est la taille, en TCHARs, de la mémoire tampon nécessaire pour contenir le chemin et le caractère null de fin.
Si la fonction échoue pour une autre raison, par exemple si le fichier n’existe pas, la valeur de retour est zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Sur de nombreux systèmes de fichiers, un nom de fichier court contient un caractère tilde (~). Toutefois, tous les systèmes de fichiers ne suivent pas cette convention. Par conséquent, ne supposez pas que vous pouvez ignorer l’appel de GetLongPathNameTransacted si le chemin d’accès ne contient pas de caractère tilde (~).
Si un chemin long est introuvable, cette fonction retourne le nom spécifié dans le paramètre lpszShortPath dans le paramètre lpszLongPath .
Si la valeur de retour est supérieure à la valeur spécifiée dans cchBuffer, vous pouvez rappeler la fonction avec une mémoire tampon suffisamment grande pour contenir le chemin. Pour obtenir un exemple de ce cas, consultez la section Exemple de code pour GetFullPathName.
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 GetLongPathNameTransacted 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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour