SHCreateDirectoryExA.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

SHCreateDirectoryExA (SHELL32.@)

SYNOPSIS

int SHCreateDirectoryExA
 (
  HWND                  hWnd,
  LPCSTR                path,
  LPSECURITY_ATTRIBUTES sec
 )

DESCRIPTION

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

PARAMS

hWnd [In] .

path [In] path of directory to create.

sec [In] security attributes to use or NULL.

RETURNS

ERROR_SUCCESS or one of the following values: ERROR_BAD_PATHNAME or ERROR_PATH_NOT_FOUND if the path is relative ERROR_INVALID_NAME if the path contains invalid chars ERROR_FILE_EXISTS when a file with that name exists ERROR_ALREADY_EXISTS when the directory already exists ERROR_FILENAME_EXCED_RANGE if the filename was to long to process.

FIXME: Not implemented yet; SHCreateDirectoryEx also verifies that the files in the directory will be visible if the path is a network path to deal with network drivers which might have a limited but unknown maximum path length. If not:

If hWnd 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 ERROR_CANCELLED.

If hWnd is set to NULL, no user interface is displayed and the function returns ERROR_CANCELLED.

IMPLEMENTATION

Defined in "shlobj.h".

Implemented in "dlls/shell32/shlfileop.c".

Debug channel "shell".