简介

C++

VB声明

说明

返回值

参数表

简介

CreateDirectory, CreateDirectoryEx

C++

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 remote application interface (RAPI) version of this function exists, and it is named CeCreateDirectory.

BOOL CreateDirectory(LPCTSTR lpPathName, LPSECURITY_ATTRIBUTES lpSecurityAttributes );

ParameterslpPathName [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 the CreateDirectory function parses paths.

lpSecurityAttributes [in] Ignored; set to NULL. Return ValuesNonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

RemarksSome file systems, such as NTFS, 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 its parent directory.

第一个参数值为文件夹名称，第二个参数值为安全属性，一般设置为NULL即可。如果正确创建，返回值为1，如果没有正常创建文件夹，则返回0。

特别的：该函数每次调用时都只能创建一级文件夹，即文件夹中不能再包含子文件夹。

当希望创建含有子文件夹的文件夹时，可以先使用该函数创建一级文件夹，然后再使用该函数在一级文件夹下创建子文件夹。如：

希望创建：d:\\\\TEST\\\\temp，

则：CString str = “d:\\\\TEST”;

CreateDirectory(str, NULL);

str = str + \\\\temp;

CreateDirectory(str, NULL);

VB声明

Declare Function CreateDirectory& Lib "kernel32" Alias "CreateDirectoryA" (ByVal lpNewDirectory As String, lpSecurityAttributes As SECURITY_ATTRIBUTES)

Declare Function CreateDirectoryEx& Lib "kernel32" Alias "CreateDirectoryExA" (ByVal lpTemplateDirectory As String, ByVal lpNewDirectory As String, lpSecurityAttributes As SECURITY_ATTRIBUTES)

说明

创建一个新目录

返回值

Long，非零表示成功，零表示失败。会设置GetLastError

参数表

参数 类型及说明

lpTemplateDirectory String，指定一个模板目录的名字，从中复制默认属性（比如目录中文件的默认压缩方式）。如设为vbNullString，则表示不使用模板

lpNewDirectory String，新目录的名字

lpSecurityAttributes SECURITY_ATTRIBUTES，这个结构定义了目录的安全特性——如果操作系统支持的话

Windows API

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, and it is named CeCreateDirectory (RAPI).

BOOL CreateDirectory(

LPCTSTR lpPathName,

LPSECURITY_ATTRIBUTES lpSecurityAttributes

);

Parameters

lpPathName

[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 the CreateDirectory function parses paths.

lpSecurityAttributes

[in] Ignored; set to NULL.

Return Values

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

Remarks

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 its parent directory.

Requirements

OS Versions: Windows CE 1.0 and later.

Header: Winbase.h.

Link Library: Coredll.lib.

See Also

CeCreateDirectory (RAPI) | CreateFile | RemoveDirectory