Método IBackgroundCopyJob::SetNotifyFlags (bits.h)

Especifica el tipo de notificación de eventos que desea recibir, como los eventos transferidos del trabajo.

Sintaxis

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

[in] Val

Establezca una o varias de las marcas siguientes para identificar los eventos que desea recibir.

Valor	Significado
BG_NOTIFY_JOB_TRANSFERRED 0x0001	Todos los archivos del trabajo se han transferido.
BG_NOTIFY_JOB_ERROR 0x0002	Se ha producido un error.
BG_NOTIFY_DISABLE 0x0004	La notificación de eventos está deshabilitada. BITS omite las otras marcas.
BG_NOTIFY_JOB_MODIFICATION 0x0008	El trabajo se ha modificado. Por ejemplo, un valor de propiedad cambiado, el estado del trabajo ha cambiado o se realiza la transferencia de los archivos. Esta marca se omite en devoluciones de llamada de línea de comandos si se especifica la notificación de línea de comandos .
BG_NOTIFY_FILE_TRANSFERRED 0x0010	Se ha transferido un archivo en el trabajo. Esta marca se omite en devoluciones de llamada de línea de comandos si se especifica la notificación de línea de comandos .
BG_NOTIFY_FILE_RANGES_TRANSFERRED 0x0020	Se ha transferido un intervalo de bytes en el archivo. Esta marca se omite en devoluciones de llamada de línea de comandos si se especifica la notificación de línea de comandos . La marca se puede especificar para cualquier trabajo, pero solo recibirá notificaciones de trabajos que cumplan los requisitos de un trabajo de BITS_JOB_PROPERTY_ON_DEMAND_MODE .

Este método devuelve los siguientes valores HRESULT , así como otros.

Código devuelto	Descripción
S_OK	El tipo de notificación de eventos se estableció correctamente.
E_NOTIMPL	El valor NotifyFlags no es válido.
BG_E_INVALID_STATE	El estado del trabajo no puede ser BG_JOB_STATE_CANCELLED ni BG_JOB_STATE_ACKNOWLEDGED.

Use el método SetNotifyFlags junto con los métodos IBackgroundCopyJob::SetNotifyInterface e IBackgroundCopyJob2::SetNotifyCmdLine para recibir notificaciones de eventos.

Vea el código de ejemplo del método IBackgroundCopyJob::SetNotifyInterface .