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