On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

CreateDirectory

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
);

Parameters

lpPathName

Points 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 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".

lpSecurityAttributes

Pointer to a SECURITY_ATTRIBUTES structure that determines whether the returned handle can be inherited by child processes. If lpSecurityAttributes is NULL, the handle cannot be inherited.

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.

Return Values

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.

Remarks

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.

See Also

CreateDirectoryEx, CreateFile, RemoveDirectory, SECURITY_ATTRIBUTES

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

CreateDirectory

Функция CreateDirectory создает новый директорий. Если основная файловая система поддерживает безопасности в файлах и директориях, функция прилагает определенный дескриптор безопасности к новому директорию. Отметьте, что CreateDirectory нет имеет параметр шаблона, тогда как CreateDirectoryEx делает.

BOOL CreateDirectory(

LPCTSTR lpPathName, // УКАЗАТЕЛЬ в строку пути указателя директория LPSECURITY_ATTRIBUTES lpSecurityAttributes // в дескриптор безопасности
);

Параметры

lpPathName

Точки на недействительный расторгнутую строку, которые определяют путь директория, который нужно создаваться.

Есть предел размера встроенной строки для путей символов MAX_PATH. Этот предел обусловливается, чтобы как функциональные пути грамматических разборов CreateDirectory.
Окно NT: приложение может превзойти этот предел и посылаться в пути более длинные чем символы MAX_PATH вызывая широкую версию (W) CreateDirectory и добавляя "\\?\" в путь. "\\?\" Сообщает функцию, чтобы выключать синтаксический анализ пути; это позволяет пути дольше чем MAX_PATH использован CreateDirectoryW. Это также работает с именами UNC. "\\?\" Проигнорирован как часть пути. Например, "\\?\C:\myworld\private" виден как " C:\myworld\private", и "\\?\UNC\bill_g_1\hotstuff\coolapps" виден как "\\bill_g_1\hotstuff\coolapps".

lpSecurityAttributes

Указатель в структуру SECURITY_ATTRIBUTES, которая определяет может возвращанная ручка быть унаследована процессами ребенка. Если lpSecurityAttributes НЕДЕЙСТВИТЕЛЕН, ручка не может быть унаследована.

Окно NT: член lpSecurityDescriptor структуры определяет дескриптор безопасности для нового директория. Если lpSecurityAttributes НЕДЕЙСТВИТЕЛЕН, директорий получает встроенный дескриптор безопасности. Целевая файловая система должна поддержать безопасности в файлах и директориях для этого параметра, чтобы воздействовать.
Окно 95: член lpSecurityDescriptor структуры проигнорирован.

Обратные Величины

Если функция добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Windows NT: Немного файловые системы, как например, NTFS, поддержка сжатия для индивидуальных файлов и директориев. В объемах отформатированных для такой файловой системы, новый директорий наследует атрибут сжатия своего родительского директория.
Windows NT: приложение может получить ручку в директорий вызывая CreateFile с флагом FILE_FLAG_BACKUP_SEMANTICS установленным. Для кодового примера, смотри CreateFile.

Смотри Также

CreateDirectoryEx, CreateFile, RemoveDirectory, SECURITY_ATTRIBUTES

Используются технологии uCoz