WerRegisterCustomMetadata 函式 (werapi.h)
針對 Windows 錯誤報告 (WER) 錯誤報告,以索引鍵/值字串的形式註冊要 (收集的應用程式特定元數據) 。
語法
HRESULT WerRegisterCustomMetadata(
PCWSTR key,
PCWSTR value
);
參數
key
所註冊之元數據專案的 「key」 字串。
value
所註冊之元數據元素的值字串。
傳回值
此函式會在成功或失敗時傳回錯誤碼 S_OK ,包括下列錯誤碼。
傳回碼 | Description |
---|---|
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 |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |