Función CreateDirectory (winbase.h)

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

Sintaxis

BOOL CreateDirectory(
  [in]           LPCTSTR               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 : espacio suficiente 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, vea Asignar nombre a un archivo

[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 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).

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. Para obtener información de error extendida, llame a GetLastError. Entre los posibles errores se incluyen los siguientes.

Observaciones

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.

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. Consulte propagación automática de acees heredables para obtener más información.

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

Ejemplos

Para obtener un ejemplo, vea recuperar y cambiar atributos de archivo.

Requisitos

Consulte también

createDirectoryEx

CreateDirectoryTransacted

CreateFile

Creación y eliminación de directorios

funciones de administración de directorios de

removeDirectory

SECURITY_ATTRIBUTES

SECURITY_INFORMATION