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 "include/shlobj.h". gitlab.winehq.org/wine/wine/blob/master/include/shlobj.h

Implemented in "dlls/shell32/shlfileop.c". gitlab.winehq.org/wine/wine/blob/master/dlls/shell32/shlfileop.c

Debug channel "shell".


Copyright © 2024 The Wine Project. All trademarks are the property of their respective owners. Visit WineHQ for license details. Generated Nov 2024.