Metodo IBackgroundCopyJob::SetNotifyFlags (bits.h)

Specifica il tipo di notifica degli eventi che si desidera ricevere, ad esempio eventi trasferiti dal processo.

Sintassi

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

[in] Val

Impostare uno o più flag seguenti per identificare gli eventi che si desidera ricevere.

Valore	Significato
BG_NOTIFY_JOB_TRANSFERRED 0x0001	Tutti i file nel processo sono stati trasferiti.
BG_NOTIFY_JOB_ERROR 0x0002	un errore.
BG_NOTIFY_DISABLE 0x0004	La notifica degli eventi è disabilitata. BITS ignora gli altri flag.
BG_NOTIFY_JOB_MODIFICATION 0x0008	Il processo è stato modificato. Ad esempio, un valore della proprietà è cambiato, lo stato del processo è stato modificato o lo stato viene eseguito il trasferimento dei file. Questo flag viene ignorato nei callback della riga di comando se viene specificata la notifica della riga di comando.
BG_NOTIFY_FILE_TRANSFERRED 0x0010	È stato trasferito un file nel processo. Questo flag viene ignorato nei callback della riga di comando se viene specificata la notifica della riga di comando.
BG_NOTIFY_FILE_RANGES_TRANSFERRED 0x0020	È stato trasferito un intervallo di byte nel file. Questo flag viene ignorato nei callback della riga di comando se viene specificata la notifica della riga di comando. Il flag può essere specificato per qualsiasi processo, ma si otterranno solo notifiche per i processi che soddisfano i requisiti per un processo di BITS_JOB_PROPERTY_ON_DEMAND_MODE .

Questo metodo restituisce i valori HRESULT seguenti, nonché altri.

Codice restituito	Descrizione
S_OK	Il tipo di notifica degli eventi è stato impostato correttamente.
E_NOTIMPL	Il valore NotifyFlags non è valido.
BG_E_INVALID_STATE	Lo stato del processo non può essere BG_JOB_STATE_CANCELLED o BG_JOB_STATE_ACKNOWLEDGED.

Utilizzare il metodo SetNotifyFlags insieme ai metodi IBackgroundCopyJob::SetNotifyInterface e IBackgroundCopyJob2::SetNotifyCmdLine per ricevere la notifica degli eventi.

Vedere il codice di esempio per il metodo IBackgroundCopyJob::SetNotifyInterface .

Requisito	Valore
Client minimo supportato	Windows XP
Server minimo supportato	Windows Server 2003
Piattaforma di destinazione	Windows
Intestazione	bits.h
Libreria	Bits.lib
DLL	QmgrPrxy.dll