Función SHCreateDirectory (shlobj_core.h)

[SHCreateDirectory está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Crea una nueva carpeta del sistema de archivos.

Sintaxis

int SHCreateDirectory(
  [in, optional] HWND   hwnd,
  [in]           PCWSTR pszPath
);

Parámetros

[in, optional] hwnd

Tipo: HWND

Controlador para una ventana primaria. Este parámetro se puede establecer en NULL si no se muestra ninguna interfaz de usuario.

[in] pszPath

Tipo: PCWSTR

Puntero a una cadena Unicode terminada en null que contiene la ruta de acceso completa del directorio. Esta cadena no debe tener más de MAX_PATH caracteres, incluido el carácter nulo de terminación.

Valor devuelto

Tipo: int

Devuelve ERROR_SUCCESS si se ejecuta correctamente. Si se produce un error en la operación, se pueden devolver otros códigos de error, incluidos los enumerados aquí. Para obtener valores que no se enumeran específicamente, consulte Códigos de error del sistema.

Código devuelto	Descripción
ERROR_BAD_PATHNAME	El parámetro pszPath se estableció en una ruta de acceso relativa.
ERROR_FILENAME_EXCED_RANGE	La ruta a la que apunta pszPath es demasiado larga.
ERROR_FILE_EXISTS	El directorio existe.
ERROR_ALREADY_EXISTS	El directorio existe.
ERROR_CANCELLED	El usuario canceló la operación.

Comentarios

Esta función crea una carpeta del sistema de archivos cuya ruta de acceso completa recibe pszPath. Si no existen una o varias de las carpetas intermedias, las crea.

Para establecer atributos de seguridad en una carpeta nueva, use SHCreateDirectoryEx.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h (incluya Shlobj.h)
Library	Shell32.lib
Archivo DLL	Shell32.dll (versión 5.0 o posterior)

Consulte también

SHCreateDirectoryEx