Función AMGetErrorTextW (errors.h)

La función AMGetErrorText recupera el mensaje de error de un código de retorno determinado mediante la configuración de idioma actual.

Esta función convierte HRESULT códigos de retorno en mensajes de error. La constante MAX_ERROR_TEXT_LEN especifica el número máximo de caracteres en un mensaje de error.

Sintaxis

AMOVIEAPI DWORD AMGetErrorTextW(
  HRESULT hr,
  LPWSTR  pbuffer,
  DWORD   MaxLen
);

Parámetros

hr

valor de HRESULT.

pbuffer

Puntero a un búfer de caracteres que recibe el mensaje de error.

MaxLen

Número de caracteres de pBuffer.

Valor devuelto

Devuelve el número de caracteres devueltos en el búfer o cero si se produjo un error.

Observaciones

Nota

El encabezado errors.h define AMGetErrorText como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
de la plataforma de destino de Windows
encabezado de errors.h
biblioteca de Quartz.lib

Consulte también

funciones de

  • Last updated on