Функция 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