Metode ITask::SetApplicationName (mstask.h)

[[API ini dapat diubah atau tidak tersedia dalam versi sistem operasi atau produk berikutnya. Silakan gunakan Antarmuka Penjadwal Tugas 2.0 sebagai gantinya.] ]

Metode ini menetapkan aplikasi tertentu ke tugas saat ini.

Sintaks

HRESULT SetApplicationName(
  [in] LPCWSTR pwszApplicationName
);

Parameter

[in] pwszApplicationName

String yang dihentikan null yang berisi nama aplikasi yang akan dikaitkan dengan tugas. Gunakan string kosong untuk menghapus nama aplikasi.

Nilai kembali

Metode SetApplicationName mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
E_INVALIDARG	Argumen tidak valid.
E_OUTOFMEMORY	Memori tidak cukup tersedia.

Keterangan

Jika Anda tidak menentukan jalur untuk aplikasi, Penjadwal Tugas mencari jalur lingkungan untuk menemukan jalur yang benar. Jika nama aplikasi menentukan program, nama harus menggunakan ekstensi .exe untuk memastikan bahwa antarmuka pengguna Task Scheduler menampilkan ikon aplikasi dengan benar.

Setelah memanggil SetApplicationName, pastikan Anda memanggil IPersistFile::Simpan untuk menyimpan tugas yang dimodifikasi ke disk.

Contoh

Untuk contoh cara mengatur nama aplikasi, lihat Contoh Kode C/C++: Mengatur Nama Aplikasi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	mstask.h
Pustaka	Mstask.lib
DLL	Mstask.dll
Redistribusi	Internet Explorer 4.0 atau yang lebih baru pada Windows NT 4.0 dan Windows 95

Lihat juga

GetApplicationName

ITask