IBackgroundCopyJob ::SetNotifyFlags, méthode (bits.h)

Spécifie le type de notification d’événement que vous souhaitez recevoir, comme les événements transférés par le travail.

Syntaxe

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

[in] Val

Définissez un ou plusieurs des indicateurs suivants pour identifier les événements que vous souhaitez recevoir.

Valeur	Signification
BG_NOTIFY_JOB_TRANSFERRED 0x0001	Tous les fichiers du travail ont été transférés.
BG_NOTIFY_JOB_ERROR 0x0002	Une erreur s’est produite.
BG_NOTIFY_DISABLE 0x0004	La notification d’événement est désactivée. BITS ignore les autres indicateurs.
BG_NOTIFY_JOB_MODIFICATION 0x0008	Le travail a été modifié. Par exemple, une valeur de propriété a changé, l’état du travail a changé ou la progression est effectuée lors du transfert des fichiers. Cet indicateur est ignoré dans les rappels de ligne de commande si la notification de ligne de commande est spécifiée.
BG_NOTIFY_FILE_TRANSFERRED 0x0010	Un fichier dans le travail a été transféré. Cet indicateur est ignoré dans les rappels de ligne de commande si la notification de ligne de commande est spécifiée.
BG_NOTIFY_FILE_RANGES_TRANSFERRED 0x0020	Une plage d’octets dans le fichier a été transférée. Cet indicateur est ignoré dans les rappels de ligne de commande si la notification de ligne de commande est spécifiée. L’indicateur peut être spécifié pour n’importe quel travail, mais vous recevrez uniquement des notifications pour les travaux qui répondent aux exigences d’un travail BITS_JOB_PROPERTY_ON_DEMAND_MODE .

Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.

Code de retour	Description
S_OK	Le type de notification d’événement a été correctement défini.
E_NOTIMPL	La valeur NotifyFlags n’est pas valide.
BG_E_INVALID_STATE	L’état du travail ne peut pas être BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED.

Utilisez la méthode SetNotifyFlags conjointement avec les méthodes IBackgroundCopyJob ::SetNotifyInterface et IBackgroundCopyJob2 ::SetNotifyCmdLine pour recevoir une notification d’événement.

Consultez l’exemple de code de la méthode IBackgroundCopyJob ::SetNotifyInterface .

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
Plateforme cible	Windows
En-tête	bits.h
Bibliothèque	Bits.lib
DLL	QmgrPrxy.dll