Wine API: SHCreateDirectoryExA

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 too 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

Declared in "shlobj.h". https://source.winehq.org/source/include/shlobj.h

Implemented in "dlls/shell32/shlfileop.c". https://source.winehq.org/source/dlls/shell32/shlfileop.c

Debug channel "shell".