IBackgroundCopyJob::SetNotifyFlags-Methode (bits.h)
Gibt den Typ der Ereignisbenachrichtigung an, die Sie erhalten möchten, z. B. auftragsbasierte Ereignisse.
Syntax
HRESULT SetNotifyFlags(
[in] ULONG Val
);
Parameter
[in] Val
Legen Sie mindestens eins der folgenden Flags fest, um die Ereignisse zu identifizieren, die Sie empfangen möchten.
| Wert | Bedeutung |
|---|---|
|
Alle Dateien im Auftrag wurden übertragen. |
|
Es ist ein Fehler aufgetreten. |
|
Ereignisbenachrichtigung ist deaktiviert. BITS ignoriert die anderen Flags. |
|
Der Auftrag wurde geändert. Beispielsweise hat sich ein Eigenschaftswert geändert, der Status des Auftrags wurde geändert, oder es wird ein Fortschritt beim Übertragen der Dateien gemacht. Dieses Flag wird in Befehlszeilenrückrufen ignoriert, wenn die Befehlszeilenbenachrichtigung angegeben ist. |
|
Eine Datei im Auftrag wurde übertragen. Dieses Flag wird in Befehlszeilenrückrufen ignoriert, wenn die Befehlszeilenbenachrichtigung angegeben ist. |
|
Ein Bytebereich in der Datei wurde übertragen. Dieses Flag wird in Befehlszeilenrückrufen ignoriert, wenn die Befehlszeilenbenachrichtigung angegeben ist. Das Flag kann für jeden Auftrag angegeben werden, aber Sie erhalten nur Benachrichtigungen für Aufträge, die die Anforderungen für einen BITS_JOB_PROPERTY_ON_DEMAND_MODE Auftrag erfüllen. |
Rückgabewert
Diese Methode gibt die folgenden HRESULT-Werte sowie andere zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Typ der Ereignisbenachrichtigung wurde erfolgreich festgelegt. |
|
Der NotifyFlags-Wert ist ungültig. |
|
Der Status des Auftrags kann nicht BG_JOB_STATE_CANCELLED oder BG_JOB_STATE_ACKNOWLEDGED werden. |
Hinweise
Verwenden Sie die SetNotifyFlags-Methode in Verbindung mit den Methoden IBackgroundCopyJob::SetNotifyInterface und IBackgroundCopyJob2::SetNotifyCmdLine , um Ereignisbenachrichtigungen zu empfangen.
Beispiele
Sehen Sie sich den Beispielcode für die IBackgroundCopyJob::SetNotifyInterface-Methode an.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Zielplattform | Windows |
| Kopfzeile | bits.h |
| Bibliothek | Bits.lib |
| DLL | QmgrPrxy.dll |
Weitere Informationen
IBackgroundCopyJob2::SetNotifyCmdLine