ITaskFolder::Metode CreateFolder (taskschd.h)

Membuat folder untuk tugas terkait.

Sintaksis

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 nullITaskFolder penunjuk antarmuka. Mereferensikan pointer NULL non-dapat menyebabkan kebocoran memori karena pointer akan ditimpa.

Mengembalikan nilai

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

Komentar

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

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

Lihat juga

ITaskFolder

Penjadwal Tugas