Metode ITaskScheduler::SetTargetComputer (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 SetTargetComputer memilih komputer tempat antarmuka ITaskScheduler beroperasi, memungkinkan manajemen dan enumerasi tugas jarak jauh.

Sintaks

HRESULT SetTargetComputer(
  [in] LPCWSTR pwszComputer
);

Parameter

[in] pwszComputer

Penunjuk ke string karakter lebar yang dihentikan null yang menentukan nama komputer target untuk instans antarmuka ITaskScheduler saat ini. Tentukan nama komputer target dalam format Universal Naming Convention (UNC). Untuk menunjukkan komputer lokal, atur nilai ini ke NULL atau ke nama UNC komputer lokal.

Catatan Saat menentukan nama komputer jarak jauh, gunakan dua karakter garis miring terbelakang (\\) sebelum nama komputer. Misalnya, gunakan "\\ComputerName" alih-alih "ComputerName".
 

Nilai kembali

Metode SetTargetComputer mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
S_OK
Metode berhasil.
SCHED_E_SERVICE_NOT_INSTALLED
Layanan Penjadwal Tugas tidak diinstal pada komputer target.
E_ACCESS_DENIED
Pengguna tidak memiliki akses ke komputer jarak jauh.
E_INVALIDARG
Parameter pwszComputer tidak valid.
E_OUTOFMEMORY
Terjadi kegagalan alokasi memori.

Keterangan

Untuk komputer Windows Server 2003, Windows XP untuk membuat, memantau, atau mengontrol tugas pada komputer Windows Vista, operasi berikut harus diselesaikan pada komputer Windows Vista, dan pengguna yang memanggil metode ITaskScheduler::SetTargetComputer harus menjadi anggota grup Administrator pada komputer Windows Vista jarak jauh.

Aktifkan pengecualian "Bagikan File dan Printer" di Windows Firewall

  1. Klik Mulai, lalu klik Panel Kontrol.
  2. Di Panel Kontrol, klik Tampilan Klasik lalu klik dua kali ikon Windows Firewall.
  3. Di jendela Windows Firewall, klik tab Pengecualian dan pilih kotak centang Pengecualian Berbagi File dan Printer .

Aktifkan layanan "Remote Registry"

  • Buka jendela Prompt Perintah dan masukkan perintah berikut: mulai bersih "Remote Registry"

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header mstask.h
Pustaka Mstask.lib
DLL Mstask.dll

Lihat juga

ITaskScheduler