Fonction SHCreateDirectory (shlobj_core.h)

Article
08/26/2023

[SHCreateDirectory est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Crée un dossier de système de fichiers.

Syntaxe

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

Paramètres

[in, optional] hwnd

Type : HWND

Handle vers une fenêtre parent. Ce paramètre peut être défini sur NULL si aucune interface utilisateur n’est affichée.

[in] pszPath

Type : PCWSTR

Pointeur vers une chaîne Unicode terminée par null qui contient le chemin complet du répertoire. Cette chaîne ne doit pas comporter plus de MAX_PATH caractères, y compris le caractère null de fin.

Valeur retournée

Type : int

Retourne ERROR_SUCCESS en cas de réussite. Si l’opération échoue, d’autres codes d’erreur peuvent être retournés, y compris ceux répertoriés ici. Pour les valeurs qui ne sont pas spécifiquement répertoriées, consultez Codes d’erreur système.

Code de retour	Description
ERROR_BAD_PATHNAME	Le paramètre pszPath a été défini sur un chemin relatif.
ERROR_FILENAME_EXCED_RANGE	Le chemin pointé vers pszPath est trop long.
ERROR_FILE_EXISTS	Le répertoire existe.
ERROR_ALREADY_EXISTS	Le répertoire existe.
ERROR_CANCELLED	L’utilisateur a annulé l’opération.

Remarques

Cette fonction crée un dossier de système de fichiers dont le chemin complet est donné par pszPath. Si un ou plusieurs des dossiers intermédiaires n’existent pas, il les crée.

Pour définir des attributs de sécurité sur un nouveau dossier, utilisez SHCreateDirectoryEx.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)

Voir aussi

SHCreateDirectoryEx

Partager via