Interfaccia IBackgroundCopyCallback1 (qmgr.h)

  • Articolo

[IBackgroundCopyCallback1 è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece le interfacce BITS.

Implementare l'interfaccia IBackgroundCopyCallback1 per ricevere notifiche quando si verificano gli eventi. Le applicazioni usano questa interfaccia come opzione per eseguire il polling dello stato del gruppo.

Per ricevere notifiche, chiamare il metodo IBackgroundCopyGroup::SetProp per impostare le proprietà GROUPPROP_NOTIFYCLSID e GROUPPROP_NOTIFYFLAGS .

QMGR usa il puntatore all'interfaccia mentre è valido (il puntatore di interfaccia diventa non valido quando l'applicazione viene chiusa). Quando l'applicazione viene riavviata, è necessario reimpostare la proprietà GROUPPROP_NOTIFYCLSID in tali gruppi che QMGR sta ancora elaborando.

Nota QMGR attiva il nuovo oggetto nell'ambito del processo client; le notifiche non vengono eseguite nel proprio processo. QMGR crea un nuovo oggetto di tale CLSID e passa un puntatore di interfaccia a BITS.
 
È necessario implementare tutti i metodi dell'interfaccia IBackgroundCopyCallback1 . Come minimo, il metodo deve restituire S_OK. Per ridurre la probabilità che il callback blocchi BITS, mantenere breve l'implementazione.

Se un amministratore assume la proprietà del gruppo, i callback di notifica vengono eseguiti nel contesto dell'utente che ha richiesto la notifica.

Ereditarietà

L'interfaccia IBackgroundCopyCallback1 eredita dall'interfaccia IUnknown . IBackgroundCopyCallback1 include anche questi tipi di membri:

Metodi

L'interfaccia IBackgroundCopyCallback1 include questi metodi.

 
IBackgroundCopyCallback1::OnStatus

Implementare il metodo OnStatus per ricevere una notifica quando il gruppo è completo o si verifica un errore.

Requisiti

   
Client minimo supportato Windows XP
Server minimo supportato Windows Server 2003
Piattaforma di destinazione Windows
Intestazione qmgr.h