Specifies the type of event notification you want to receive, such as job transferred events.
HRESULT SetNotifyFlags( ULONG Val );
Set one or more of the following flags to identify the events that you want to receive.
||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.
||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.|
See the example code for the IBackgroundCopyJob::SetNotifyInterface method.
|Minimum supported client||Windows XP|
|Minimum supported server||Windows Server 2003|