Función CreateDirectoryA (fileapi.h)

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

Para especificar un directorio de plantilla, use la función CreateDirectoryEx .

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

Sintaxis

BOOL CreateDirectoryA(
  [in]           LPCSTR                lpPathName,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

Parámetros

[in] lpPathName

Ruta de acceso del directorio que se va a crear.

Para la versión ANSI de esta función, hay un límite de tamaño de cadena predeterminado para las rutas de acceso de 248 caracteres (MAX_PATH - suficiente espacio para un nombre de archivo 8.3). Para ampliar este límite a 32 767 caracteres anchos, llame a la versión Unicode de la función y anteponga "\\?\" a la ruta de acceso. Para obtener más información, consulte Nomenclatura de un archivo.

Propina A partir de Windows 10, versión 1607, para la versión unicode de esta función (CreateDirectoryW), puede optar por quitar la limitación de caracteres de 248 sin prepending "\\?\". Todavía se aplica el límite de 255 caracteres por segmento de ruta de acceso. 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, 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 ACL del descriptor de seguridad predeterminado de 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).

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. 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
No existen uno o más directorios intermedios; esta función solo creará el directorio final en la ruta de acceso.

Comentarios

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 sistema de archivos, un nuevo directorio hereda los atributos de compresión y cifrado de su directorio primario.

Una aplicación puede obtener un identificador para un directorio llamando a CreateFile con la marca FILE_FLAG_BACKUP_SEMANTICS establecida. Para obtener un ejemplo de código, vea 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, consulte Propagación automática de ASE heredables .

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

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

Ejemplos

Para obtener un ejemplo, consulte Recuperación y cambio de atributos de archivo.

Nota

El encabezado fileapi.h define CreateDirectory 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado fileapi.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

CreateDirectoryEx

CreateDirectoryTransacted

CreateFile

Crear y eliminar directorios

Funciones de administración de directorios

RemoveDirectory

SECURITY_ATTRIBUTES

SECURITY_INFORMATION