Función CreateDirectoryTransactedA (winbase.h)

Artículo
11/20/2024

[Microsoft recomienda encarecidamente que los desarrolladores usen medios alternativos para lograr las necesidades de la aplicación. Muchos escenarios para los que se desarrolló TxF se pueden lograr a través de técnicas más sencillas y disponibles con mayor facilidad. Además, es posible que TxF no esté disponible en versiones futuras de Microsoft Windows. Para obtener más información y alternativas a TxF, consulte Alternativas al uso de NTFS transaccional.]

Crea un nuevo directorio como una operación de transacción, con los atributos de un directorio de plantilla especificado. Si el sistema de archivos subyacente admite la seguridad en archivos y directorios, la función aplica un descriptor de seguridad especificado al nuevo directorio. El nuevo directorio conserva los demás atributos del directorio de plantilla especificado.

Sintaxis

BOOL CreateDirectoryTransactedA(
  [in, optional] LPCSTR                lpTemplateDirectory,
  [in]           LPCSTR                lpNewDirectory,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [in]           HANDLE                hTransaction
);

Parámetros

[in, optional] lpTemplateDirectory

Ruta de acceso del directorio que se va a usar como plantilla al crear el nuevo directorio. Este parámetro puede ser null.

De forma predeterminada, el nombre se limita a MAX_PATH caracteres. Para ampliar este límite a 32 767 caracteres anchos, anteponga "\\?\\ " a la ruta de acceso. Para obtener más información, vea Archivos de nomenclatura, rutas de acceso y espacios de nombres.

Propina

A partir de Windows 10, versión 1607, puedes optar por quitar la limitación del MAX_PATH sin tener que prepending "\\?\". Consulte la sección "Limitación máxima de longitud de ruta de acceso" de Archivos de nomenclatura, rutas de acceso y espacios de nombres para obtener más información.

El directorio debe residir en el equipo local; De lo contrario, se produce un error en la función y el último código de error se establece en ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE.

[in] lpNewDirectory

Ruta de acceso del directorio que se va a crear.

Propina

[in, optional] lpSecurityAttributes

Puntero a una estructura SECURITY_ATTRIBUTES. El lpSecurityDescriptor miembro de la estructura especifica un descriptor de seguridad para el nuevo directorio.

Si lpSecurityAttributes es NULL, el directorio obtiene un descriptor de seguridad predeterminado. Las listas de control de acceso (ACL) del descriptor de seguridad predeterminado para un directorio se heredan de su directorio primario.

El sistema de archivos de destino debe admitir la seguridad en archivos y directorios para que este parámetro tenga un efecto. Esto se indica cuando getVolumeInformation devuelve FS_PERSISTENT_ACLS.

[in] hTransaction

Identificador de la transacción. El función createTransaction devuelve este identificador.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero (0). Para obtener información de error extendida, llame a GetLastError. Entre los posibles errores se incluyen los siguientes.

Código devuelto	Descripción
ERROR_ALREADY_EXISTS	El directorio especificado ya existe.
ERROR_EFS_NOT_ALLOWED_IN_TRANSACTION	No se puede crear un directorio secundario con un directorio primario que tenga deshabilitado el cifrado.
ERROR_PATH_NOT_FOUND	No existen uno o varios directorios intermedios. Esta función solo crea el directorio final en la ruta de acceso.

Observaciones

La función CreateDirectoryTransacted permite crear directorios que hereden información de flujo de otros directorios. Esta función es útil, por ejemplo, cuando se usan directorios de Macintosh, que tienen una secuencia de recursos necesaria para identificar correctamente el contenido del directorio como atributo.

Algunos sistemas de archivos, como el sistema de archivos NTFS, admiten compresión o cifrado para archivos y directorios individuales. En los volúmenes con formato para este tipo de sistema de archivos, un nuevo directorio hereda los atributos de compresión y cifrado de su directorio primario.

Esta función produce un error con ERROR_EFS_NOT_ALLOWED_IN_TRANSACTION si intenta crear un directorio secundario con un directorio primario que tenga deshabilitado el cifrado.

Puede obtener un identificador para un directorio llamando a la función CreateFileTransacted con la marca FILE_FLAG_BACKUP_SEMANTICS establecida.

En Windows 8 y Windows Server 2012, esta función es compatible con las siguientes tecnologías.

Tecnología	Soportado
Protocolo bloque de mensajes del servidor (SMB) 3.0	No
Conmutación por error transparente (TFO) de SMB 3.0	No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO)	No
Sistema de archivos de volumen compartido de clúster (CsvFS)	No
Sistema de archivos resistente (ReFS)	No

SMB 3.0 no admite TxF.

Nota

El encabezado winbase.h define CreateDirectoryTransacted como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2008 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winbase.h (incluya Windows.h)
biblioteca de	Kernel32.lib
DLL de	Kernel32.dll