CreateDirectory (Compact 2013)


This function creates a new directory. If the underlying file system supports security on files and directories, the function applies a specified security descriptor to the new directory.

BOOL CreateDirectory(
  LPCTSTR lpPathName, 
  LPSECURITY_ATTRIBUTES lpSecurityAttributes 


[in] Long pointer to a null-terminated string that specifies the path of the directory to be created.

There is a default string size limit for paths of MAX_PATH characters. This limit is related to how this function parses paths.


[in] Ignored; set to NULL.

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

This function is not recursive. It can create only the final directory in a path. That is, if a parent or intermediate directory does not exist, the function fails with error message ERROR_PATH_NOT_FOUND.

Some file systems, such as NTFS file system, support compression or encryption for individual files and directories. On volumes formatted for such a file system, a new directory inherits the compression and encryption attributes of the parent directory.

The full path is put into canonical form before this function processes a path name. Therefore, trailing backslashes in a user-provided path name are ignored.