Please use FireFox to view this page

Visual Basic 6 definition

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

Visual Basic .NET definition

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

C# definition

[DllImport("kernel32.dll", SetLastError=true)] static extern int CreateDirectoryExA ( string lpTemplateDirectory, string lpNewDirectory, ref SECURITY_ATTRIBUTES lpSecurityAttributes)

Types (click icon to expand)

SECURITY_ATTRIBUTES

Structure SECURITY_ATTRIBUTES Dim nLength As Integer Dim lpSecurityDescriptor As Integer Dim bInheritHandle As Integer End Structure

struct SECURITY_ATTRIBUTES{ int nLength; int lpSecurityDescriptor; int bInheritHandle; }

Description

CreateDirectoryEx creates a new directory on a disk. It also allows you to specify the security attributes of the newly created directory, if the operating system supports it. The newly created directory will inherit most of its attributes (except security) from a template directory specified by the function. For example, the new directory will have the same file attributes as the template directory.

Return Value

If an error occured, the function returns 0 (use GetLastError to get the error code). If successful, the function returns a non-zero value.

Parameters

lpTemplateDirectory The name of the directory to use as an attribute template for creating the new directory. lpNewDirectory The name of the new directory to create. lpSecurityAttributes Windows NT, 2000: The security attributes to assign to the newly created directory. Windows 95, 98, CE: This parameter is ignored.

Further Information:

For further information on Windows API functions such as these, and how to use these API's in your C# and VB.NET applications, please refer to the book 'Network programming in .NET' (Buy at Amazon UK) (Buy at Amazon US)

Visual Basic 6 example source code
' Create the new directory C:\Dummy\NewDir and ' give it default security attributes. It will inherit its properties from the ' directory C:\Recycled (the "Recycle Bin") -- although this won't be another ' recycle bin, it will have the Hidden and System attributes. Dim secattr As SECURITY_ATTRIBUTES ' security attributes structure Dim retval As Long ' return value ' Set the desired security attributes secattr.nLength = Len(secattr) ' size of the structure secattr.lpSecurityDescriptor = 0 ' default (normal) level of security secattr.bInheritHandle = 1 ' this is the default setting ' Create the directory, using C:\Recycled as the template. retval = CreateDirectoryEx("C:\Recycled", "C:\Dummy\NewDir", secattr)
C# example source code

Provide a code example

C#
VB.NET
VB6