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

Artículo
02/23/2024

Recupera el texto del error asociado al error.

Sintaxis

HRESULT GetErrorDescription(
  [in]  DWORD  LanguageId,
  [out] LPWSTR *pErrorDescription
);

Parámetros

[in] LanguageId

Identifica la configuración regional que se va a usar para generar la descripción. Para crear el identificador de idioma, use la macro MAKELANGID . Por ejemplo, para especificar inglés de EE. UU., use el ejemplo de código siguiente.

MAKELANGID(LANG_ENGLISH, SUBLANG_ENGLISH_US)

Para recuperar el identificador de idioma de usuario predeterminado del sistema, use las siguientes llamadas.

LANGIDFROMLCID(GetThreadLocale())

[out] pErrorDescription

Cadena terminada en NULL que contiene el texto de error asociado al error. Llame a la función CoTaskMemFree para liberar ppErrorDescription cuando haya terminado.

Valor devuelto

Este método devuelve los siguientes valores HRESULT , así como otros.

Código devuelto	Descripción
S_OK	Descripción del error se recuperó correctamente.
E_OUTOFMEMORY	Memoria insuficiente para completar la operación.
E_INVALIDARG	El parámetro LanguageId no puede ser 0.
HRESULT_FROM_WIN32(ERROR_RESOURCE_LANG_NOT_FOUND)	No hay ninguna cadena disponible para la configuración regional.

Comentarios

También puede llamar al método IBackgroundCopyManager::GetErrorDescription para recuperar el texto de error asociado a un código de error.

Las descripciones de los errores HTTP se localizan.

Windows XP/2000: Las descripciones de los errores HTTP no se localizan.

Ejemplos

Consulte el código de ejemplo en el tema Control de errores .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP
Servidor mínimo compatible	Windows Server 2003
Plataforma de destino	Windows
Encabezado	bits.h
Library	Bits.lib
Archivo DLL	QmgrPrxy.dll