Partager via


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
);

Paramètres

[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 .

Valeur retournée

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.

Remarques

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

Exemples

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

Configuration requise

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

Voir aussi

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob2 ::SetNotifyCmdLine

IBackgroundCopyJob ::GetNotifyFlags

IBackgroundCopyJob ::SetNotifyInterface