Compartilhar via


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

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

Sintaxe

HRESULT SetNotifyFlags(
  [in] ULONG Val
);

Parâmetros

[in] Val

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

Valor Significado
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 é 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 .

Retornar valor

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

Código de retorno Descrição
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.

Comentários

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

Exemplos

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Servidor mínimo com suporte Windows Server 2003
Plataforma de Destino Windows
Cabeçalho bits.h
Biblioteca Bits.lib
DLL QmgrPrxy.dll

Confira também

IBackgroundCopyCallback

IBackgroundCopyCallback2

IBackgroundCopyJob2::SetNotifyCmdLine

IBackgroundCopyJob::GetNotifyFlags

IBackgroundCopyJob::SetNotifyInterface