Fonction ResUtilCreateDirectoryTree (resapi.h)

Crée chaque répertoire spécifié dans un chemin d’accès, en ignorant les répertoires qui existent déjà. Le type PRESUTIL_CREATE_DIRECTORY_TREE définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilCreateDirectoryTree(
  [in] LPCWSTR pszPath
);

Paramètres

[in] pszPath

Pointeur vers une chaîne Unicode terminée par un caractère Null spécifiant un chemin. La chaîne peut se terminer par une barre oblique inverse de fin.

Valeur retournée

Si l’opération réussit, la fonction retourne ERROR_SUCCESS.

Si l’opération échoue, la fonction retourne un code d’erreur système.

Remarques

Si le chemin contient uniquement une spécification de lecteur (L"c :\ »), ResUtilCreateDirectoryTree retourne ERROR_SUCCESS mais n’effectue aucune action.

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 Entreprise, Windows Server 2008 Datacenter
Plateforme cible	Windows
En-tête	resapi.h
Bibliothèque	ResUtils.lib
DLL	ResUtils.dll