Freigeben über


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

Siehe auch

ITaskFolder-

Aufgabenplaner-