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.
A RAPI version of this function exists called CeCreateDirectory (RAPI).
BOOL CreateDirectory( LPCTSTR lpPathName, LPSECURITY_ATTRIBUTES lpSecurityAttributes );
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.