GetFileAttributesTransactedW, fonction (winbase.h)

Article
03/03/2024

[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.]

Récupère les attributs du système de fichiers pour un fichier ou un répertoire spécifié en tant qu’opération transactionnelle.

Syntaxe

BOOL GetFileAttributesTransactedW(
  [in]  LPCWSTR                lpFileName,
  [in]  GET_FILEEX_INFO_LEVELS fInfoLevelId,
  [out] LPVOID                 lpFileInformation,
  [in]  HANDLE                 hTransaction
);

Paramètres

[in] lpFileName

Nom du fichier ou du répertoire.

Le fichier ou le répertoire 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 larges, 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 MAX_PATH sans précédencer « \\ ?\ ». Pour plus d’informations, consultez la section « Limitation maximale de la longueur du chemin d’accès » de Naming Files, Paths et Namespaces .

[in] fInfoLevelId

Niveau d’informations d’attribut à récupérer.

Ce paramètre peut être la valeur suivante de l’énumération GET_FILEEX_INFO_LEVELS .

Valeur	Signification
GetFileExInfoStandard	Le paramètre lpFileInformation est une structure WIN32_FILE_ATTRIBUTE_DATA .

[out] lpFileInformation

Pointeur vers une mémoire tampon qui reçoit les informations d’attribut.

Le type d’informations d’attribut stockées dans cette mémoire tampon est déterminé par la valeur de fInfoLevelId. Si le paramètre fInfoLevelId est GetFileExInfoStandard, ce paramètre pointe vers une structure WIN32_FILE_ATTRIBUTE_DATA

[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 (0). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Lorsque GetFileAttributesTransacted est appelé sur un répertoire qui est un dossier monté, il retourne les attributs du répertoire, et non ceux du répertoire racine dans le volume que le dossier monté associe au répertoire. Pour obtenir les attributs de fichier du volume associé, appelez GetVolumeNameForVolumeMountPoint pour obtenir le nom du volume associé. Utilisez ensuite le nom résultant dans un appel à GetFileAttributesTransacted. Les résultats sont les attributs du répertoire racine sur le volume associé.

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.

Liens symboliques : Si le chemin pointe vers un lien symbolique, la fonction retourne les attributs du lien symbolique.

Opérations traitées

Si un fichier est ouvert pour modification dans une transaction, aucun autre thread ne peut ouvrir le fichier pour modification tant que la transaction n’est pas validée. À l’inverse, si un fichier est ouvert pour modification en dehors d’une transaction, aucun thread traité ne peut ouvrir le fichier pour modification tant que le handle non traité n’est pas fermé. Si un thread non traité a un handle ouvert pour modifier un fichier, un appel à GetFileAttributesTransacted pour ce fichier échoue avec une erreur ERROR_TRANSACTIONAL_CONFLICT .

Notes

L’en-tête winbase.h définit GetFileAttributesTransacted comme un 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. Le mélange 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