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 |
|---|---|
|
Operasi berhasil. |
|
Argumen tidak valid. |
|
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 |