Compartir a través de

Función ResUtilCreateDirectoryTree (resapi.h)

  • Artículo

Crea todos los directorios especificados en una ruta de acceso, omitiendo directorios que ya existen. El tipo PRESUTIL_CREATE_DIRECTORY_TREE define un puntero a esta función.

Sintaxis

DWORD ResUtilCreateDirectoryTree(
  [in] LPCWSTR pszPath
);

Parámetros

[in] pszPath

Puntero a una cadena Unicode terminada en null que especifica una ruta de acceso. La cadena puede terminar con una barra diagonal inversa final.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve ERROR_SUCCESS.

Si se produce un error en la operación, la función devuelve un código de error del sistema.

Comentarios

Si la ruta de acceso solo contiene una especificación de unidad (L"c:\"), ResUtilCreateDirectoryTree devolverá ERROR_SUCCESS pero no realizará ninguna acción.

Ejemplos

// BEFORE
//   C:
//   |--Program Files
//      |-- MyApp
//          |--Data
ResUtilCreateDirectoryTree( L"C:\\Program Files\\MyApp\\Startup\\Parameters\\Users" );

ResUtilCreateDirectoryTree( L"C:\\Program Files\\MyApp\\Data\\Archive\\" );

ResUtilCreateDirectoryTree( L"C:\\Program Files\\MyApp\\Bin" );

// This call will return ERROR_SUCCESS even though all directories
// in the path already exist.
ResUtilCreateDirectoryTree( L"C:\\Program Files\\MyApp\\Bin" );

// AFTER
//   C:
//   |--Program Files
//      |--MyApp
//         |--Bin
//         |--Data
//         |  |--Archive
//         |--Startup
//            |--Parameters
//               |--Users
//

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de destino Windows
Encabezado resapi.h
Library ResUtils.lib
Archivo DLL ResUtils.dll