Функция AMGetErrorTextW (errors.h)

Функция AMGetErrorText извлекает сообщение об ошибке для заданного кода возврата с помощью текущего параметра языка.

Эта функция преобразует HRESULT коды возврата в сообщения об ошибках. Константная MAX_ERROR_TEXT_LEN указывает максимальное количество символов в сообщении об ошибке.

Синтаксис

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

Параметры

hr

значение HRESULT.

pbuffer

Указатель на буфер символов, получающий сообщение об ошибке.

MaxLen

Количество символов в pBuffer.

Возвращаемое значение

Возвращает количество символов, возвращаемых в буфере, или ноль, если произошла ошибка.

Замечания

Заметка

Заголовок errors.h определяет AMGetErrorText как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
целевая платформа Виндоус
заголовка errors.h
библиотеки Qualcom.lib

См. также

Функции