CreateDirectoryTransactedW, fonction (winbase.h)

Article
03/13/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.]

Crée un répertoire en tant qu’opération traitée, avec les attributs d’un répertoire de modèle spécifié. Si le système de fichiers sous-jacent prend en charge la sécurité sur les fichiers et les répertoires, la fonction applique un descripteur de sécurité spécifié au nouveau répertoire. Le nouveau répertoire conserve les autres attributs du répertoire de modèle spécifié.

Syntaxe

BOOL CreateDirectoryTransactedW(
  [in, optional] LPCWSTR               lpTemplateDirectory,
  [in]           LPCWSTR               lpNewDirectory,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [in]           HANDLE                hTransaction
);

Paramètres

[in, optional] lpTemplateDirectory

Chemin d’accès du répertoire à utiliser comme modèle lors de la création du nouveau répertoire. Ce paramètre peut être NULL..

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] lpNewDirectory

Chemin du répertoire à créer.

Conseil

[in, optional] lpSecurityAttributes

Pointeur vers une structure SECURITY_ATTRIBUTES . Le membre lpSecurityDescriptor de la structure spécifie un descripteur de sécurité pour le nouveau répertoire.

Si lpSecurityAttributes a la valeur NULL, le répertoire obtient un descripteur de sécurité par défaut. Les listes de contrôle d’accès (ACL) dans le descripteur de sécurité par défaut d’un répertoire sont héritées de son répertoire parent.

Le système de fichiers cible doit prendre en charge la sécurité sur les fichiers et les répertoires pour que ce paramètre ait un effet. Cela est indiqué lorsque GetVolumeInformation retourne FS_PERSISTENT_ACLS.

[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. Les erreurs possibles sont les suivantes.

Code de retour	Description
ERROR_ALREADY_EXISTS	Le répertoire spécifié existe déjà.
ERROR_EFS_NOT_ALLOWED_IN_TRANSACTION	Vous ne pouvez pas créer un répertoire enfant avec un répertoire parent dont le chiffrement est désactivé.
ERROR_PATH_NOT_FOUND	Un ou plusieurs répertoires intermédiaires n’existent pas. Cette fonction crée uniquement le répertoire final dans le chemin d’accès.

Remarques

La fonction CreateDirectoryTransacted vous permet de créer des répertoires qui héritent des informations de flux d’autres répertoires. Cette fonction est utile, par exemple, lorsque vous utilisez des répertoires Macintosh, qui ont un flux de ressources nécessaire pour identifier correctement le contenu du répertoire en tant qu’attribut.

Certains systèmes de fichiers, tels que le système de fichiers NTFS, prennent en charge la compression ou le chiffrement des fichiers et répertoires individuels. Sur les volumes mis en forme pour un tel système de fichiers, un nouveau répertoire hérite des attributs de compression et de chiffrement de son répertoire parent.

Cette fonction échoue avec ERROR_EFS_NOT_ALLOWED_IN_TRANSACTION si vous essayez de créer un répertoire enfant avec un répertoire parent dont le chiffrement est désactivé.

Vous pouvez obtenir un handle dans un répertoire en appelant la fonction CreateFileTransacted avec l’indicateur FILE_FLAG_BACKUP_SEMANTICS défini.

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 CreateDirectoryTransacted 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