Metode ITaskFolder::CreateFolder (taskschd.h)

Membuat folder untuk tugas terkait.

Sintaks

HRESULT CreateFolder(
  [in]  BSTR        subFolderName,
  [in]  VARIANT     sddl,
  [out] ITaskFolder **ppFolder
);

Parameter

[in] subFolderName

Nama yang digunakan untuk mengidentifikasi folder. Jika "FolderName\SubFolder1\SubFolder2" ditentukan, seluruh pohon folder akan dibuat jika folder tidak ada. Parameter ini dapat menjadi jalur relatif ke instans ITaskFolder saat ini. Folder tugas akar ditentukan dengan garis miring terbelakang (\). Contoh jalur folder tugas, di bawah folder tugas akar, adalah \MyTaskFolder. Karakter '.' tidak dapat digunakan untuk menentukan folder tugas saat ini dan '..' karakter tidak dapat digunakan untuk menentukan folder tugas induk di jalur.

[in] sddl

Deskriptor keamanan yang terkait dengan folder, dalam bentuk VT_BSTR dalam format SDDL_REVISION_1.

[out] ppFolder

Antarmuka ITaskFolder yang mewakili subfolder baru.

Berikan referensi ke penunjuk antarmuka ITaskFolderNULL. Mereferensikan pointer non-NULL dapat menyebabkan kebocoran memori karena pointer akan ditimpa.

Nilai kembali

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Untuk mengambil subfolder folder induk, gunakan metode GetFolders .

Metode CreateFolder akan mengembalikan 0x800700b7 jika folder yang Anda coba buat sudah ada.

Menentukan deskriptor keamanan yang tidak valid dalam parameter sddl akan menyebabkan metode ini mengembalikan E_INVALIDARG.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	taskschd.h
Pustaka	Taskschd.lib
DLL	Taskschd.dll

Lihat juga

ITaskFolder

Tugas Microsoft Azure Scheduler