Méthode ibackgroundcopyjob :: SetNotifyFlags, méthode

Spécifie le type de notification d’événement que vous souhaitez recevoir, par exemple les événements de transfert de travaux.

Syntaxe

HRESULT SetNotifyFlags(
  [in] ULONG NotifyFlags
);

Paramètres

NotifyFlags [ dans]

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
Non pris en charge.
BG_NOTIFY_JOB_MODIFICATION
0x0008
La tâche a été modifiée. Par exemple, une valeur de propriété a été modifiée, l’état de la tâche a changé ou la progression est effectuée en transférant les fichiers. Cet indicateur est ignoré si la notification de ligne de commande est spécifiée.
BG_NOTIFY_FILE_TRANSFERRED
0x0010
Un fichier du travail a été transféré. Cet indicateur est ignoré si la notification de ligne de commande est spécifiée.
BG_NOTIFY_FILE_RANGES_TRANSFERRED
0x0020
Non pris en charge.

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.
DO_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 méthode ibackgroundcopyjob :: SetNotifyInterface.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 10, les applications de bureau version 1709 [ uniquement]
Serveur minimal pris en charge
Windows Serveur, version 1709 [ applications de bureau uniquement]
En-tête
Deliveryoptimization. h
MIDL
DeliveryOptimization. idl
Bibliothèque
Dosvc. lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyJob est défini en tant que 37668D37-507E-4160-9316-26306D150B12

Voir aussi

Méthode ibackgroundcopyjob

IBackgroundCopyCallback

Méthode ibackgroundcopyjob :: GetNotifyFlags

Méthode ibackgroundcopyjob :: SetNotifyInterface