Condividi tramite


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
);

Parametri

[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 .

Valore restituito

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.

Commenti

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

Esempio

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

Requisiti

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

Vedi anche

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob2::SetNotifyCmdLine

IBackgroundCopyJob::GetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface