ITaskService::Metode connect (taskschd.h)

Artikel
08/26/2023

Menyambungkan ke komputer jarak jauh dan mengaitkan semua panggilan berikutnya pada antarmuka ini dengan sesi jarak jauh. Jika parameter serverName kosong, maka metode ini akan dijalankan di komputer lokal. Jika pengguna tidak ditentukan, maka token saat ini digunakan.

Sintaks

HRESULT Connect(
  [in, optional] VARIANT serverName,
  [in, optional] VARIANT user,
  [in, optional] VARIANT domain,
  [in, optional] VARIANT password
);

Parameter

[in, optional] serverName

Nama komputer yang ingin Anda sambungkan. Jika parameter serverName kosong, maka metode ini akan dijalankan di komputer lokal.

[in, optional] user

Nama pengguna yang digunakan selama koneksi ke komputer. Jika pengguna tidak ditentukan, maka token saat ini digunakan.

[in, optional] domain

Domain pengguna yang ditentukan dalam parameter pengguna .

[in, optional] password

Kata sandi yang digunakan untuk menyambungkan ke komputer. Jika nama pengguna dan kata sandi tidak ditentukan, maka token saat ini digunakan.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Mengembalikan kode/nilai	Deskripsi
S_OK 0	Operasi berhasil diselesaikan.
E_ACCESS_DENIED 0x80070005	Akses ditolak untuk tersambung ke layanan Penjadwal Tugas.
SCHED_E_SERVICE_NOT_RUNNING 0x80041315	Layanan Penjadwal Tugas tidak berjalan.
E_OUTOFMEMORY 0x8007000e	Aplikasi tidak memiliki cukup memori untuk menyelesaikan operasi atau pengguna, kata sandi, atau domain memiliki setidaknya satu nilai null dan satu non-null.
ERROR_BAD_NETPATH 53	Kesalahan ini dikembalikan dalam situasi berikut: Nama komputer yang ditentukan dalam parameter serverName tidak ada. Ketika Anda mencoba menyambungkan ke komputer Windows Server 2003 atau Windows XP, dan komputer jarak jauh tidak mengaktifkan pengecualian firewall Berbagi File dan Pencetak atau layanan Registri Jarak Jauh tidak berjalan. Ketika Anda mencoba tersambung ke komputer Windows Vista, dan komputer jarak jauh tidak mengaktifkan pengecualian firewall Manajemen Tugas Terjadwal Jarak Jauh dan pengecualian tembok api Berbagi File dan Pencetak diaktifkan, atau layanan Registri Jarak Jauh tidak berjalan.
ERROR_NOT_SUPPORTED 50	Parameter pengguna, kata sandi, atau domain tidak dapat ditentukan ketika menyambungkan ke komputer Windows XP atau Windows Server 2003 jarak jauh dari komputer Windows Vista.

Keterangan

Metode ITaskService::Connect harus dipanggil sebelum memanggil salah satu metode ITaskService lainnya.

Jika Anda ingin menyambungkan ke komputer Windows Vista jarak jauh dari Windows Vista, Anda perlu memperbolehkan pengecualian firewall Manajemen Tugas Terjadwal Jarak Jauh pada komputer jarak jauh. Untuk memperbolehkan pengecualian ini klik Mulai, Panel Kontrol, Keamanan, Perbolehkan program melalui Windows Firewall, lalu pilih kotak centang Manajemen Tugas Terjadwal Jarak Jauh. Lalu klik tombol Ok dalam kotak dialog Pengaturan Windows Firewall.

Jika Anda tersambung ke komputer Windows XP atau Windows Server 2003 jarak jauh dari komputer Windows Vista, Anda perlu memperbolehkan pengecualian firewall Berbagi File dan Pencetak pada komputer jarak jauh. Untuk memperbolehkan pengecualian ini klik Mulai, Panel Kontrol, klik dua kali Windows Firewall, pilih tab Pengecualian, lalu pilih pengecualian firewall Berbagi File dan Printer. Kemudian klik tombol OK dalam kotak dialog Windows Firewall. Layanan Remote Registry juga harus berjalan pada komputer jarak jauh.

CatatanITaskService::Connect dapat mengembalikan kesalahan SCHED_E_INVALIDVALUE saat membaca definisi tugas jika skema tugas jarak jauh tidak didukung oleh komputer saat ini. Untuk memverifikasi versi skema tertinggi yang didukung oleh komputer saat ini, periksa properti ITaskService::HighestVersion .

Persyaratan


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

Lihat juga

ITaskService

ITaskService::HighestVersion

Bagikan melalui