Fungsi SetNetScheduleAccountInformation (atacct.h)

Artikel
02/26/2024

[SetNetScheduleAccountInformation tidak lagi tersedia untuk digunakan pada Windows 8. Sebagai gantinya, gunakan Antarmuka Task Scheduler 2.0.

]

Fungsi SetNetScheduleAccountInformation mengatur nama dan kata sandi akun Layanan AT. Nama akun dan kata sandi Layanan AT digunakan sebagai kredensial untuk pekerjaan terjadwal yang dibuat dengan NetScheduleJobAdd.

Sintaks

HRESULT SetNetScheduleAccountInformation(
  [in] LPCWSTR pwszServerName,
  [in] LPCWSTR pwszAccount,
  [in] LPCWSTR pwszPassword
);

Parameter

[in] pwszServerName

String karakter lebar yang dihentikan NULL untuk nama komputer yang informasi akunnya sedang diatur.

[in] pwszAccount

Penunjuk ke string karakter lebar yang dihentikan NULL untuk akun tersebut. Untuk menentukan akun sistem lokal, atur parameter ini ke NULL.

[in] pwszPassword

Penunjuk ke string karakter lebar yang dihentikan NULL untuk kata sandi. Untuk informasi tentang mengamankan informasi kata sandi, lihat Menangani Kata Sandi.

Nilai kembali

Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan nama akun dan kata sandi berhasil ditetapkan. Nilai lain menunjukkan kondisi kesalahan.

Jika fungsi gagal, beberapa nilai yang mungkin dikembalikan tercantum di bawah ini.

Mengembalikan kode/nilai	Deskripsi
E_ACCESSDENIED 0x080070005	Akses ditolak. Kesalahan ini dikembalikan jika penelepon bukan anggota grup Administrator. Kesalahan ini juga dikembalikan jika parameter pwszAccount bukan NULL yang menunjukkan akun bernama bukan akun sistem lokal dan parameter pwszPassword salah untuk akun yang ditentukan dalam parameter pwszAccount .
HRESULT_FROM_WIN32(ERROR_INVALID_DATA) 0x08007000d	Data tidak valid. Kesalahan ini dikembalikan jika parameter pwszPassword adalah NULL atau panjang string parameter pwszPassword terlalu panjang.
SCHED_E_ACCOUNT_NAME_NOT_FOUND 0x80041310	Tidak dapat menetapkan keberadaan akun yang ditentukan. Kesalahan ini dikembalikan jika parameter pwszAccount bukan NULL yang menunjukkan akun bernama bukan akun sistem lokal dan parameter pwszAccount tidak dapat ditemukan.

Keterangan

SetNetScheduleAccountInformation meniru pemanggil. Hanya anggota grup Administrator lokal di komputer tempat informasi akun jadwal diatur yang berhasil menjalankan fungsi ini. Perhatikan bahwa kata sandi NULL tidak diperbolehkan.

Persyaratan

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

Lihat juga

GetNetScheduleAccountInformation

Bagikan melalui