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

Artigo
02/28/2024

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

Share via