.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH SHCreateDirectoryExA 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBSHCreateDirectoryExA\fR (SHELL32.@)
.SH SYNOPSIS
int SHCreateDirectoryExA
 (
  HWND                  \fIhWnd\fR,
  LPCSTR                \fIpath\fR,
  LPSECURITY_ATTRIBUTES \fIsec\fR
 )

.SH DESCRIPTION
.PP
This function creates a file system folder whose fully qualified \fIpath\fR is given by \fIpath\fR. If one or more of the intermediate folders do not exist, they will be created as well. 

.SH PARAMS
\fIhWnd\fR \fB[In]\fR  \fB.\fR
.PP
\fIpath\fR \fB[In]\fR  \fIpath\fR of directory to create.
.PP
\fIsec\fR \fB[In]\fR  security attributes to use or \fBNULL\fR.
.PP

.SH RETURNS
.PP
\fBERROR_SUCCESS\fR or one of the following values: \fBERROR_BAD_PATHNAME\fR or \fBERROR_PATH_NOT_FOUND\fR if the \fIpath\fR is relative \fBERROR_INVALID_NAME\fR if the \fIpath\fR contains invalid chars \fBERROR_FILE_EXISTS\fR when a file with that name exists \fBERROR_ALREADY_EXISTS\fR when the directory already exists \fBERROR_FILENAME_EXCED_RANGE\fR if the filename was to long to process. 
.PP
\fBFIXME:\fR Not implemented yet; SHCreateDirectoryEx also verifies that the files in the directory will be visible if the \fIpath\fR is a network \fIpath\fR to deal with network drivers which might have a limited but unknown maximum \fIpath\fR length. If not: 
.PP
If \fIhWnd\fR is set to a valid window handle, a message box is displayed warning the user that the files may not be accessible. If the user chooses not to proceed, the function returns \fBERROR_CANCELLED\fR. 
.PP
If \fIhWnd\fR is set to \fBNULL\fR, no user interface is displayed and the function returns \fBERROR_CANCELLED\fR. 

.SH IMPLEMENTATION
.PP
Declared in \fB"shlobj.h"\fR. 
.PP
Implemented in \fB"dlls/shell32/shlfileop.c"\fR. 
.PP
Debug channel \fB"shell"\fR.