Bagikan melalui


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