werRegisterCustomMetadata 函数 (werapi.h)

注册要 (以键/值字符串的形式收集的应用特定元数据，) Windows 错误报告 (WER) 错误报告。

语法

HRESULT WerRegisterCustomMetadata(
  PCWSTR key,
  PCWSTR value
);

key

正在注册的元数据元素的“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) ，方法是将应用元数据与其进程对应的故障报告相关联。