Compartilhar via

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

Especifica um nome de exibição para o trabalho. Normalmente, você usa o nome de exibição para identificar o trabalho em uma interface do usuário.

Sintaxe

HRESULT SetDisplayName(
  [in] LPCWSTR Val
);

Parâmetros

[in] Val

Cadeia de caracteres terminada em nulo que identifica o trabalho. Não deve ser NULL. O comprimento da cadeia de caracteres é limitado a 256 caracteres, não incluindo o terminador nulo.

Valor de retorno

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

Código de retorno Description
S_OK
 O nome de exibição foi definido com êxito.
E_INVALIDARG
 O parâmetro pDisplayName não pode ser NULL ou o nome excede 256 caracteres.
BG_E_STRING_TOO_LONG
 O nome de exibição excede 256 caracteres.
BG_E_INVALID_STATE
 O estado do trabalho não pode ser BG_JOB_STATE_CANCELLED ou BG_JOB_STATE_ACKNOWLEDGED.

Observações

O nome de exibição é originalmente definido quando você cria o trabalho. Para obter detalhes sobre como especificar o nome de exibição ao criar o trabalho, consulte o método IBackgroundCopyManager::CreateJob .

Requirements

Requirement Value
Cliente mínimo suportado Windows XP
Servidor mínimo compatível Windows Server 2003
da Plataforma de Destino Windows
Header bits.h
Library Bits.lib
de DLL QmgrPrxy.dll

Consulte também

IBackgroundCopyJob::GetDisplayName

IBackgroundCopyManager::CreateJob

  • Last updated on