The CreateDirectory 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. Note that CreateDirectory does not have a template parameter, while CreateDirectoryEx does.
BOOL CreateDirectory(
LPCTSTR lpPathName, |
// pointer to a directory path string |
LPSECURITY_ATTRIBUTES lpSecurityAttributes |
// pointer to a security descriptor |
); |
There is a default string size limit for paths of MAX_PATH characters. This limit is related to how the CreateDirectory function parses paths.
Windows NT: An application can transcend this limit and send in paths
longer than MAX_PATH characters by calling the wide (W) version of CreateDirectory
and prepending “\\?\” to the path.
The “\\?\” tells the function to
turn off path parsing; it lets paths longer than MAX_PATH be used with CreateDirectoryW.
This also works with UNC names. The “\\?\”
is ignored as part of the path. For example, “\\?\C:\myworld\private”
is seen as “C:\myworld\private”,
and “\\?\UNC\bill_g_1\hotstuff\coolapps”
is seen as “\\bill_g_1\hotstuff\coolapps”.
Windows NT: The lpSecurityDescriptor member of the structure specifies a security descriptor for the new directory. If lpSecurityAttributes is NULL, the directory gets a default security descriptor. The target file system must support security on files and directories for this parameter to have an effect.
Windows 95: The lpSecurityDescriptor member of the structure is ignored.
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Windows NT: Some file systems, such as NTFS, support compression for individual files and directories. On volumes formatted for such a file system, a new directory inherits the compression attribute of its parent directory.
Windows NT: An application can obtain a handle to a directory by calling CreateFile with the FILE_FLAG_BACKUP_SEMANTICS flag set. For a code example, see CreateFile.
CreateDirectoryEx, CreateFile, RemoveDirectory, SECURITY_ATTRIBUTES
See:
file: /Techref/os/win/api/win32/func/src/f09_2.htm, 4KB, , updated: 2001/6/26 10:21, local time: 2024/12/8 19:34,
18.97.14.82:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://www.piclist.com/techref/os/win/api/win32/func/src/f09_2.htm"> CreateDirectory</A> |
Did you find what you needed? |
PICList 2024 contributors:
o List host: MIT, Site host massmind.org, Top posters @none found - Page Editors: James Newton, David Cary, and YOU! * Roman Black of Black Robotics donates from sales of Linistep stepper controller kits. * Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters. * Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated! * Contributors: Richard Seriani, Sr. |
Welcome to www.piclist.com! |
.