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) ,方法是将应用元数据与其进程对应的故障报告相关联。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10版本 1703 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2016 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | werapi.h |
Library | Kernel32.lib |
DLL | Kernel32.dll |