Función CreateDirectoryExW (winbase.h)

Artículo
03/03/2024

Crea un directorio 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.

Para realizar esta operación como una operación de transacción, use la función CreateDirectoryTransacted .

Sintaxis

BOOL CreateDirectoryExW(
  [in]           LPCWSTR               lpTemplateDirectory,
  [in]           LPCWSTR               lpNewDirectory,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

Parámetros

[in] lpTemplateDirectory

Ruta de acceso del directorio que se va a usar como plantilla al crear el nuevo directorio.

De forma predeterminada, el nombre está limitado 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 Nomenclatura de archivos, rutas de acceso y espacios de nombres.

Sugerencia

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

[in] lpNewDirectory

Ruta de acceso del directorio que se va a crear.

Sugerencia

[in, optional] lpSecurityAttributes

Puntero a una estructura de SECURITY_ATTRIBUTES . El miembro lpSecurityDescriptor 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 los archivos y directorios para que este parámetro tenga un efecto. Esto se indica cuando GetVolumeInformation devuelve FS_PERSISTENT_ACLS.

Valor devuelto

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

Si la función no se realiza correctamente, 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_PATH_NOT_FOUND	Uno o varios directorios intermedios no existen. Esta función solo crea el directorio final en la ruta de acceso. Para crear todos los directorios intermedios en la ruta de acceso, use la función SHCreateDirectoryEx .

Comentarios

La función CreateDirectoryEx permite crear directorios que heredan 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 la compresión o el 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.

Para obtener un identificador en un directorio, llame a la función CreateFile con el conjunto de marcas FILE_FLAG_BACKUP_SEMANTICS . Para obtener un ejemplo de código, consulte CreateFile.

Para admitir funciones de herencia que consultan el descriptor de seguridad de este objeto puede determinar y notificar de forma heurística que la herencia está en vigor. Para obtener más información, vea Propagación automática de ACE heredables.

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

Tecnología	Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0	Sí
Conmutación por error transparente (TFO) de SMB 3.0	Sí
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO)	Sí
Sistema de archivos de Volumen compartido de clúster (CsvFS)	Sí
Sistema de archivos resistente a errores (ReFS)	Sí

Nota

El encabezado winbase.h define CreateDirectoryEx 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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winbase.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll