ITaskFolder ::CreateFolder, méthode (taskschd.h)
Crée un dossier pour les tâches associées.
Syntaxe
HRESULT CreateFolder(
[in] BSTR subFolderName,
[in] VARIANT sddl,
[out] ITaskFolder **ppFolder
);
Paramètres
[in] subFolderName
Nom utilisé pour identifier le dossier. Si « FolderName\SubFolder1\SubFolder2 » est spécifié, l’arborescence de dossiers entière est créée si les dossiers n’existent pas. Ce paramètre peut être un chemin relatif de l’instance ITaskFolder actuelle. Le dossier de tâches racine est spécifié avec une barre oblique inverse (\). Un exemple de chemin d’accès au dossier de tâches, sous le dossier de tâches racine, est \MyTaskFolder. Le caractère '.' ne peut pas être utilisé pour spécifier le dossier de tâches actuel et le '..' les caractères ne peuvent pas être utilisés pour spécifier le dossier de tâches parent dans le chemin d’accès.
[in] sddl
Descripteur de sécurité associé au dossier, sous la forme d’un VT_BSTR au format SDDL_REVISION_1.
[out] ppFolder
Interface ITaskFolder qui représente le nouveau sous-dossier.
Transmettez une référence à un pointeur d’interface
Valeur de retour
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un HRESULT code d’erreur.
Remarques
Pour récupérer les sous-dossiers du dossier parent, utilisez la méthode GetFolders.
La méthode CreateFolder retourne 0x800700b7 si le dossier que vous essayez de créer existe déjà.
La spécification d’un descripteur de sécurité non valide dans le paramètre sddl
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | taskschd.h |
| bibliothèque | Taskschd.lib |
| DLL | Taskschd.dll |