SetFileAttributesTransactedW, 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 développés par TxF peuvent être réalisés par le biais de techniques plus simples et plus facilement disponibles. En outre, TxF peut ne pas être disponible dans les futures versions de Microsoft Windows. Pour plus d’informations et d’alternatives à TxF, consultez Alternatives à l’utilisation de NTFS transactionnel.]
Définit les attributs d’un fichier ou d’un répertoire en tant qu’opération transactionnelle.
Syntaxe
BOOL SetFileAttributesTransactedW(
[in] LPCWSTR lpFileName,
[in] DWORD dwFileAttributes,
[in] HANDLE hTransaction
);
Paramètres
[in] lpFileName
Nom du fichier dont les attributs doivent être définis.
Le fichier 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 des fichiers, des chemins d’accès et des espaces de noms.
Pourboire
À compter de Windows 10, version 1607, vous pouvez choisir de supprimer la limitation MAX_PATH sans précéder « \\ ?\ ». Pour plus d’informations, consultez la section « Limite maximale de longueur de chemin » de noms, fichiers, chemin s et espaces de noms.
[in] dwFileAttributes
Attributs de fichier à définir pour le fichier.
Pour obtenir la liste des valeurs d’attribut de fichier et leurs descriptions, consultez constantes d’attribut de fichier. Ce paramètre peut être une ou plusieurs valeurs, combinées à l’aide de l’opérateur OR au niveau du bit. Toutefois, toutes les autres valeurs remplacent FILE_ATTRIBUTE_NORMAL.
Tous les attributs ne sont pas pris en charge par cette fonction. Pour plus d’informations, consultez la section Remarques.
Voici une liste des valeurs d’attribut prises en charge.
FILE_ATTRIBUTE_ARCHIVE (32 (0x20))
FILE_ATTRIBUTE_HIDDEN (2 (0x2))
FILE_ATTRIBUTE_NORMAL (128 (0x80))
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED (8192 (0x2000))
FILE_ATTRIBUTE_OFFLINE (4096 (0x1000))
FILE_ATTRIBUTE_READONLY (1 (0x1))
FILE_ATTRIBUTE_SYSTEM (4 (0x4))
FILE_ATTRIBUTE_TEMPORARY (256 (0x100))
[in] hTransaction
Handle de la transaction. Ce handle est retourné par la fonction CreateTransaction.
Valeur de retour
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’erreur étendues, appelez GetLastError.
Remarques
Le tableau suivant décrit comment définir les attributs qui ne peuvent pas être définis à l’aide de SetFileAttributesTransacted. Notez que ces opérations ne sont pas traitées.
| Attribut | Guide pratique pour définir |
|---|---|
|
FILE_ATTRIBUTE_COMPRESSED
0x800 |
Pour définir l’état de compression d’un fichier, utilisez la fonction DeviceIoControl avec l’opération de FSCTL_SET_COMPRESSION. |
|
FILE_ATTRIBUTE_DEVICE
0x40 |
Réservé; n’utilisez pas. |
|
FILE_ATTRIBUTE_DIRECTORY
0x10 |
Les fichiers ne peuvent pas être convertis en répertoires. Pour créer un répertoire, utilisez la fonction CreateDirectory ou CreateDirectoryEx. |
|
FILE_ATTRIBUTE_ENCRYPTED
0x4000 |
Pour créer un fichier chiffré, utilisez la fonction CreateFile avec l’attribut FILE_ATTRIBUTE_ENCRYPTED. Pour convertir un fichier existant en fichier chiffré, utilisez la fonction EncryptFile. |
|
FILE_ATTRIBUTE_REPARSE_POINT
0x400 |
Pour associer un point d’analyse à un fichier ou un répertoire, utilisez la fonction DeviceIoControl |
|
FILE_ATTRIBUTE_SPARSE_FILE
0x200 |
Pour définir l’attribut éparse d’un fichier, utilisez la fonction DeviceIoControl avec l’opération de FSCTL_SET_SPARSE. |
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. Si un thread traité ouvre d’abord le fichier, tous les threads suivants qui tentent d’ouvrir le fichier pour modification avant la validation de la transaction recevront une violation de partage. Si un thread non traité ouvre le fichier pour modification avant que le thread traité ne le fasse et qu’il est toujours ouvert lorsque le thread transactionné tente de l’ouvrir, la transaction reçoit l’erreur ERROR_TRANSACTIONAL_CONFLICT.
Pour plus d’informations sur les transactions, consultez NTFS transactionnelle .
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Supporté |
|---|---|
| Protocole SMB (Server Message Block) 3.0 | Non |
| Basculement transparent SMB 3.0 (TFO) | Non |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | Non |
| Cluster Shared Volume File System (CsvFS) | Non |
| Système de fichiers résilient (ReFS) | Non |
SMB 3.0 ne prend pas en charge TxF.
opérations transactionnelles
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. Par conséquent, si un thread traité ouvre d’abord le fichier, tous les threads suivants qui essaient de modifier le fichier avant que la transaction ne soit validée reçoit une violation de partage. Si un thread non traité modifie le fichier avant que le thread transactionnel ne le fasse et que le fichier est toujours ouvert lorsque la transaction tente de l’ouvrir, la transaction reçoit l’erreur ERROR_TRANSACTIONAL_CONFLICT.Note
L’en-tête winbase.h définit SetFileAttributesTransacted comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winbase.h (inclure Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |
Voir aussi
constantes d’attribut de fichier