IBackgroundCopyManager::Metode CreateJob (bits.h)

Membuat pekerjaan.

Sintaks

HRESULT CreateJob(
  [in]  LPCWSTR            DisplayName,
  [in]  BG_JOB_TYPE        Type,
  [out] GUID               *pJobId,
  [out] IBackgroundCopyJob **ppJob
);

Parameter

[in] DisplayName

String yang dihentikan null yang berisi nama tampilan untuk pekerjaan tersebut. Biasanya, nama tampilan digunakan untuk mengidentifikasi pekerjaan di antarmuka pengguna. Perhatikan bahwa lebih dari satu pekerjaan mungkin memiliki nama tampilan yang sama. Tidak boleh NULL. Nama dibatasi hingga 256 karakter, tidak termasuk terminator null.

[in] Type

Jenis pekerjaan transfer, seperti BG_JOB_TYPE_DOWNLOAD. Untuk daftar jenis transfer, lihat enumerasi BG_JOB_TYPE .

[out] pJobId

Mengidentifikasi pekerjaan Anda secara unik dalam antrean. Gunakan pengidentifikasi ini saat Anda memanggil metode IBackgroundCopyManager::GetJob untuk mendapatkan pekerjaan dari antrean.

[out] ppJob

Penunjuk antarmuka IBackgroundCopyJob yang Anda gunakan untuk memodifikasi properti pekerjaan dan menentukan file yang akan ditransfer. Untuk mengaktifkan pekerjaan dalam antrean, panggil metode IBackgroundCopyJob::Resume . Lepaskan ppJob setelah selesai.

Nilai kembali

Metode ini mengembalikan nilai HRESULT berikut, serta yang lain.

Menampilkan kode	Deskripsi
S_OK	Berhasil menghasilkan pekerjaan baru.
E_INVALIDARG	Nama tampilan terlalu panjang.
BG_E_TOO_MANY_JOBS_PER_MACHINE	Pengaturan Kebijakan Grup MaxJobsPerMachine menentukan berapa banyak pekerjaan yang dapat dibuat di komputer. Menambahkan pekerjaan ini melebihi batas MaxJobsPerMachine.
BG_E_TOO_MANY_JOBS_PER_USER	Pengaturan Kebijakan Grup MaxJobsPerUser menentukan berapa banyak pekerjaan yang dapat dibuat pengguna. Menambahkan pekerjaan ini melebihi batas MaxJobsPerUser.

Keterangan

Hanya pengguna yang membuat pekerjaan atau pengguna dengan hak istimewa administrator yang dapat menambahkan file ke pekerjaan dan mengubah properti pekerjaan.

Secara default, BITS mendukung maksimum 300 pekerjaan pada satu waktu. Satu pengguna dapat membuat maksimal 60 pekerjaan pada satu waktu. Batas pengguna tidak berlaku untuk administrator atau akun layanan. Untuk mengubah default ini, atur masing-masing kebijakan grup MaxJobsPerMachine dan MaxJobsPerUser .

Sebelum Windows Vista: Tidak ada batasan jumlah pekerjaan yang didukung BITS atau yang dapat dibuat pengguna.

Untuk masalah skalabilitas, lihat Praktik Terbaik Saat Menggunakan BITS.

Contoh

Untuk contoh yang membuat pekerjaan baru, lihat Membuat Pekerjaan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP
Server minimum yang didukung	Windows Server 2003
Target Platform	Windows
Header	bits.h
Pustaka	Bits.lib
DLL	QmgrPrxy.dll

Lihat juga

Membuat Pekerjaan

IBackgroundCopyJob

IBackgroundCopyJob::Resume