Windows Mobile 6.5
A version of this page is also available for

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 


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

Windows Embedded CEWindows CE 1.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions