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 |
|---|---|
|
Tous les fichiers du travail ont été transférés. |
|
Une erreur s’est produite. |
|
La notification d’événement est désactivée. BITS ignore les autres indicateurs. |
|
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. |
|
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. |
|
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 |
|---|---|
|
Le type de notification d’événement a été correctement défini. |
|
La valeur NotifyFlags n’est pas valide. |
|
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
IBackgroundCopyJob2 ::SetNotifyCmdLine