| UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | |||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:bits.IBackgroundCopyJob.SetNotifyFlags |
IBackgroundCopyJob::SetNotifyFlags (bits.h) |
Specifies the type of event notification you want to receive, such as job transferred events. |
|
bits\ibackgroundcopyjob_setnotifyflags.htm |
Bits |
24aa6445-d7bd-4825-9121-402e63ae6f69 |
12/05/2018 |
BG_NOTIFY_DISABLE, BG_NOTIFY_FILE_RANGES_TRANSFERRED, BG_NOTIFY_FILE_TRANSFERRED, BG_NOTIFY_JOB_ERROR, BG_NOTIFY_JOB_MODIFICATION, BG_NOTIFY_JOB_TRANSFERRED, IBackgroundCopyJob interface [BITS],SetNotifyFlags method, IBackgroundCopyJob.SetNotifyFlags, IBackgroundCopyJob::SetNotifyFlags, SetNotifyFlags, SetNotifyFlags method [BITS], SetNotifyFlags method [BITS],IBackgroundCopyJob interface, _drz_ibackgroundcopyjob_setnotifyflags, bits.ibackgroundcopyjob_setnotifyflags, bits/IBackgroundCopyJob::SetNotifyFlags |
bits.h |
Windows |
Windows XP |
Windows Server 2003 |
Bits.idl |
Bits.lib |
QmgrPrxy.dll |
Windows |
19H1 |
|
|
|
|
|
|
Specifies the type of event notification you want to receive, such as job transferred events.
Set one or more of the following flags to identify the events that you want to receive.
| Value | Meaning |
|---|---|
|
All of the files in the job have been transferred. |
|
An error has occurred. |
|
Event notification is disabled. BITS ignores the other flags. |
|
The job has been modified. For example, a property value changed, the state of the job changed, or progress is made transferring the files. This flag is ignored in command-line callbacks if command line notification is specified. |
|
A file in the job has been transferred. This flag is ignored in command-line callbacks if command line notification is specified. |
|
A range of bytes in the file has been transferred. This flag is ignored in command-line callbacks if command line notification is specified. The flag can be specified for any job, but you will only get notifications for jobs that meet the requirements for a BITS_JOB_PROPERTY_ON_DEMAND_MODE job. |
This method returns the following HRESULT values, as well as others.
| Return code | Description |
|---|---|
|
Type of event notification was successfully set. |
|
The NotifyFlags value is not valid. |
|
The state of the job cannot be BG_JOB_STATE_CANCELLED or BG_JOB_STATE_ACKNOWLEDGED. |
Use the SetNotifyFlags method in conjunction with the IBackgroundCopyJob::SetNotifyInterface and IBackgroundCopyJob2::SetNotifyCmdLine methods to receive event notification.
See the example code for the IBackgroundCopyJob::SetNotifyInterface method.
IBackgroundCopyJob2::SetNotifyCmdLine