Функция WerRegisterCustomMetadata (werapi.h)

  • Статья

Регистрирует метаданные конкретного приложения для сбора (в виде строк "ключ-значение") для отчета об ошибках отчеты об ошибках Windows (WER).

Синтаксис

HRESULT WerRegisterCustomMetadata(
  PCWSTR key,
  PCWSTR value
);

Параметры

key

Строка ключа для регистрируемого элемента метаданных.

value

Строка значения для регистрируемого элемента метаданных.

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

Эта функция возвращает S_OK при успешном выполнении или код ошибки при сбое, включая следующие коды ошибок.

Код возврата Описание
E_INVALIDARG Строки имели значение NULL, длина ключа превышала 64 символа или недопустимое имя xml-элемента, длина значения превышала 128 символов или содержала символы, которые не были печатными символами ASCII.
E_OUTOFMEMORY WER не удалось выделить достаточно большую кучу для данных
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) Достигнуто максимальное количество зарегистрированных записей (WER_MAX_REGISTERED_ENTRIES) или максимальный объем зарегистрированных метаданных (WER_MAX_REGISTERED_METADATA).
WER_E_INVALID_STATE Недопустимое состояние процесса. Например, процесс находится в режиме восстановления приложения.

Комментарии

Этот API позволяет приложениям интегрировать собственные данные телеметрии на уровне приложения с телеметрией системного уровня (WER), связывая метаданные приложения с отчетами о сбоях, соответствующими их процессам.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1703 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2016 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header werapi.h
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

WerUnregisterCustomMetadata, отчеты об ошибках Windows