Metode IBackgroundCopyManager::CreateJob

Membuat pekerjaan.

Sintaks

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

Parameter

pDisplayName [in]

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.

Ketik [in]

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

pJobID [out]

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

ppJob [out]

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.

Mengembalikan nilai

Metode ini mengembalikan nilai HRESULT berikut, serta yang lain.

Menampilkan kode	Deskripsi
S_OK	Berhasil menghasilkan pekerjaan baru.

Keterangan

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1709 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server, versi 1709 [hanya aplikasi desktop]
Header	Deliveryoptimization.h
IDL	DeliveryOptimization.idl
Pustaka	Dosvc.lib
DLL	Dosvc.dll
IID	IID_IBackgroundCopyManager didefinisikan sebagai 5CE34C0D-0DC9-4C1F-897C-DAA1B78CEE7C

Lihat juga

IBackgroundCopyManager

IBackgroundCopyJob

IBackgroundCopyJob::Resume