Share via

IBackgroundCopyCallback1-Schnittstelle (qmgr.h)

  • Artikel

[IBackgroundCopyCallback1 ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die BITS-Schnittstellen.]

Implementieren Sie die IBackgroundCopyCallback1-Schnittstelle , um Benachrichtigungen zu empfangen, wenn Ereignisse auftreten. Anwendungen verwenden diese Schnittstelle als Option, um den Status der Gruppe abzufragen.

Rufen Sie zum Empfangen von Benachrichtigungen die IBackgroundCopyGroup::SetProp-Methode auf, um die Eigenschaften GROUPPROP_NOTIFYCLSID und GROUPPROP_NOTIFYFLAGS festzulegen.

QMGR verwendet den Schnittstellenzeiger, solange er gültig ist (der Schnittstellenzeiger wird ungültig, wenn Ihre Anwendung beendet wird). Wenn Ihre Anwendung neu gestartet wird, müssen Sie die eigenschaft GROUPPROP_NOTIFYCLSID für die Gruppen zurücksetzen, die QMGR noch verarbeitet.

Hinweis QMGR aktiviert das neue Objekt innerhalb des Bereichs des Clientprozesses. Benachrichtigungen werden nicht in ihrem eigenen Prozess ausgeführt. QMGR erstellt ein neues Objekt dieser CLSID und übergibt einen Schnittstellenzeiger an BITS.
 
Sie müssen alle Methoden der IBackgroundCopyCallback1-Schnittstelle implementieren. Mindestens muss die Methode S_OK zurückgeben. Um das Risiko zu verringern, dass Ihr Rückruf BITS blockiert, halten Sie Ihre Implementierung kurz.

Wenn ein Administrator den Besitz der Gruppe übernimmt, werden die Benachrichtigungsrückrufe im Kontext des Benutzers durchgeführt, der eine Benachrichtigung angefordert hat.

Vererbung

Die IBackgroundCopyCallback1-Schnittstelle erbt von der IUnknown-Schnittstelle . IBackgroundCopyCallback1 verfügt auch über die folgenden Membertypen:

Methoden

Die IBackgroundCopyCallback1-Schnittstelle verfügt über diese Methoden.

 
IBackgroundCopyCallback1::OnStatus

Implementieren Sie die OnStatus-Methode, um Benachrichtigungen zu erhalten, wenn die Gruppe abgeschlossen ist oder ein Fehler auftritt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP
Unterstützte Mindestversion (Server) Windows Server 2003
Zielplattform Windows
Kopfzeile qmgr.h