Método IBackgroundCopyJob::SetNotifyFlags (bits.h)

Especifica o tipo de notificação de evento que você deseja receber, como eventos transferidos por trabalho.

Sintaxe

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

[in] Val

Defina um ou mais dos sinalizadores a seguir para identificar os eventos que você deseja receber.

Value	Meaning
BG_NOTIFY_JOB_TRANSFERRED 0x0001	Todos os arquivos no trabalho foram transferidos.
BG_NOTIFY_JOB_ERROR 0x0002	Ocorreu um erro.
BG_NOTIFY_DISABLE 0x0004	A notificação de evento está desabilitada. O BITS ignora os outros sinalizadores.
BG_NOTIFY_JOB_MODIFICATION 0x0008	O trabalho foi modificado. Por exemplo, um valor de propriedade foi alterado, o estado do trabalho foi alterado ou o progresso foi feito transferindo os arquivos. Esse sinalizador será ignorado em retornos de chamada de linha de comando se a notificação de linha de comando for especificada.
BG_NOTIFY_FILE_TRANSFERRED 0x0010	Um arquivo no trabalho foi transferido. Esse sinalizador será ignorado em retornos de chamada de linha de comando se a notificação de linha de comando for especificada.
BG_NOTIFY_FILE_RANGES_TRANSFERRED 0x0020	Um intervalo de bytes no arquivo foi transferido. Esse sinalizador será ignorado em retornos de chamada de linha de comando se a notificação de linha de comando for especificada. O sinalizador pode ser especificado para qualquer trabalho, mas você só receberá notificações para trabalhos que atendam aos requisitos de um trabalho BITS_JOB_PROPERTY_ON_DEMAND_MODE .

Esse método retorna os seguintes valores HRESULT , bem como outros.

Código de retorno	Description
S_OK	O tipo de notificação de evento foi definido com êxito.
E_NOTIMPL	O valor notifyFlags não é válido.
BG_E_INVALID_STATE	O estado do trabalho não pode ser BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED.

Use o método SetNotifyFlags em conjunto com os métodos IBackgroundCopyJob::SetNotifyInterface e IBackgroundCopyJob2::SetNotifyCmdLine para receber a notificação do evento.

Consulte o código de exemplo para o método IBackgroundCopyJob::SetNotifyInterface .

Esta página foi útil?