Compartilhar via


Método IBackgroundCopyError::GetErrorContextDescription (bits.h)

Recupera a descrição do contexto no qual o erro ocorreu.

Sintaxe

HRESULT GetErrorContextDescription(
  [in]  DWORD  LanguageId,
  [out] LPWSTR *pContextDescription
);

Parâmetros

[in] LanguageId

Identifica a localidade a ser usada para gerar a descrição. Para criar o identificador de idioma, use a macro MAKELANGID . Por exemplo, para especificar o inglês dos EUA, use o exemplo de código a seguir.

MAKELANGID(LANG_ENGLISH, SUBLANG_ENGLISH_US)

Para recuperar o identificador de idioma de usuário padrão do sistema, use as chamadas a seguir.

LANGIDFROMLCID(GetThreadLocale())

[out] pContextDescription

Cadeia de caracteres terminada em nulo que contém a descrição do contexto no qual o erro ocorreu. Chame a função CoTaskMemFree para liberar ppContextDescription quando terminar.

Retornar valor

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

Código de retorno Descrição
S_OK
A descrição do contexto foi recuperada com êxito.
E_OUTOFMEMORY
Não há memória disponível suficiente para concluir a operação.
E_INVALIDARG
O parâmetro LanguageId não pode ser 0.
HRESULT_FROM_WIN32(ERROR_RESOURCE_LANG_NOT_FOUND)
Nenhuma cadeia de caracteres está disponível para a localidade.

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

IBackgroundCopyError::GetError

IBackgroundCopyError::GetErrorDescription

IBackgroundCopyError::GetFile