ResUtilCreateDirectoryTree-Funktion (resapi.h)

Erstellt jedes verzeichnis, das in einem Pfad angegeben ist, und überspringt bereits vorhandene Verzeichnisse. Der PRESUTIL_CREATE_DIRECTORY_TREE Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilCreateDirectoryTree(
  [in] LPCWSTR pszPath
);

Parameter

[in] pszPath

Zeiger auf eine Unicode-Zeichenfolge mit Null-Endung, die einen Pfad angibt. Die Zeichenfolge kann mit einem nachfolgenden umgekehrten Schrägstrich enden.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück.

Hinweise

Wenn der Pfad nur eine Laufwerksspezifikation (L"c:\") enthält , gibt ResUtilCreateDirectoryTreeERROR_SUCCESS aber keine Aktion aus.

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	resapi.h
Bibliothek	ResUtils.lib
DLL	ResUtils.dll