Metode IBackgroundCopyJob::SetNotifyFlags (bits.h)

Menentukan jenis pemberitahuan peristiwa yang ingin Anda terima, seperti peristiwa yang ditransfer pekerjaan.

Sintaks

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

Parameter

[in] Val

Atur satu atau beberapa bendera berikut untuk mengidentifikasi peristiwa yang ingin Anda terima.

Nilai Makna
BG_NOTIFY_JOB_TRANSFERRED
0x0001
Semua file dalam pekerjaan telah ditransfer.
BG_NOTIFY_JOB_ERROR
0x0002
Terjadi kesalahan.
BG_NOTIFY_DISABLE
0x0004
Pemberitahuan peristiwa dinonaktifkan. BITS mengabaikan bendera lainnya.
BG_NOTIFY_JOB_MODIFICATION
0x0008
Pekerjaan telah dimodifikasi. Misalnya, nilai properti berubah, status pekerjaan berubah, atau kemajuan dibuat mentransfer file. Bendera ini diabaikan dalam panggilan balik baris perintah jika pemberitahuan baris perintah ditentukan.
BG_NOTIFY_FILE_TRANSFERRED
0x0010
File dalam pekerjaan telah ditransfer. Bendera ini diabaikan dalam panggilan balik baris perintah jika pemberitahuan baris perintah ditentukan.
BG_NOTIFY_FILE_RANGES_TRANSFERRED
0x0020
Rentang byte dalam file telah ditransfer. Bendera ini diabaikan dalam panggilan balik baris perintah jika pemberitahuan baris perintah ditentukan. Bendera dapat ditentukan untuk pekerjaan apa pun, tetapi Anda hanya akan mendapatkan pemberitahuan untuk pekerjaan yang memenuhi persyaratan untuk pekerjaan BITS_JOB_PROPERTY_ON_DEMAND_MODE .

Nilai kembali

Metode ini mengembalikan nilai HRESULT berikut, serta yang lain.

Menampilkan kode Deskripsi
S_OK
Jenis pemberitahuan peristiwa berhasil diatur.
E_NOTIMPL
Nilai NotifyFlags tidak valid.
BG_E_INVALID_STATE
Status pekerjaan tidak dapat BG_JOB_STATE_CANCELLED atau BG_JOB_STATE_ACKNOWLEDGED.

Keterangan

Gunakan metode SetNotifyFlags bersama dengan metode IBackgroundCopyJob::SetNotifyInterface dan IBackgroundCopyJob2::SetNotifyCmdLine untuk menerima pemberitahuan peristiwa.

Contoh

Lihat contoh kode untuk metode IBackgroundCopyJob::SetNotifyInterface .

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

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob2::SetNotifyCmdLine

IBackgroundCopyJob::GetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface