ITaskFolder::CreateFolder-Methode (taskschd.h)
Erstellt einen Ordner für verwandte Aufgaben.
Syntax
HRESULT CreateFolder(
[in] BSTR subFolderName,
[in] VARIANT sddl,
[out] ITaskFolder **ppFolder
);
Parameter
[in] subFolderName
Der Name, der zum Identifizieren des Ordners verwendet wird. Wenn "FolderName\SubFolder1\SubFolder2" angegeben ist, wird die gesamte Ordnerstruktur erstellt, wenn die Ordner nicht vorhanden sind. Dieser Parameter kann ein relativer Pfad zur aktuellen ITaskFolder Instanz sein. Der Stammaufgabenordner wird mit einem umgekehrten Schrägstrich (\) angegeben. Ein Beispiel für einen Aufgabenordnerpfad unter dem Stammaufgabenordner ist \MyTaskFolder. Das Zeichen '.' kann nicht zum Angeben des aktuellen Aufgabenordners und des '.' verwendet werden. Zeichen können nicht verwendet werden, um den übergeordneten Aufgabenordner im Pfad anzugeben.
[in] sddl
Der sicherheitsdeskriptor, der dem Ordner zugeordnet ist, in Form eines VT_BSTR im SDDL_REVISION_1 Format.
[out] ppFolder
Eine ITaskFolder- Schnittstelle, die den neuen Unterordner darstellt.
Übergeben Sie einen Verweis auf einen NULL-ITaskFolder Schnittstellenzeiger. Das Verweisen auf einen Nicht-NULL- Zeiger kann zu einem Speicherverlust führen, da der Zeiger überschrieben wird.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Bemerkungen
Verwenden Sie zum Abrufen der Unterordner des übergeordneten Ordners die GetFolders-Methode.
Die CreateFolder--Methode gibt 0x800700b7 zurück, wenn der Ordner, den Sie erstellen möchten, bereits vorhanden ist.
Wenn Sie einen ungültigen Sicherheitsdeskriptor im sddl--Parameter angeben, wird diese Methode E_INVALIDARGzurückgeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2008 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | taskschd.h |
| Library | Taskschd.lib |
| DLL- | Taskschd.dll |