WerRegisterAdditionalProcess function (werapi.h)
Registers a process to be included in the Windows Error Reporting (WER) report along with the main application process. Optionally specifies a thread within that registered process to get additional data from.
Syntax
HRESULT WerRegisterAdditionalProcess(
DWORD processId,
[optional] DWORD captureExtraInfoForThreadId
);
Parameters
processId
The Id of the process to register.
[optional] captureExtraInfoForThreadId
The Id of a thread within the registered process from which more information is requested.
Return value
This function returns S_OK on success or an error code on failure, including the following error codes.
| Return code | Description |
|---|---|
| E_INVALIDARG | The value of processId is 0. |
| E_OUTOFMEMORY | WER could not allocate a large enough heap for the data. |
| HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | Number of WER registered entries (memory blocks, metadata, files) exceeds max (WER_MAX_REGISTERED_ENTRIES) or number of processes exceeds max (WER_MAX_REGISTERED_DUMPCOLLECTION) |
| WER_E_INVALID_STATE | The process state is not valid. For example, the process is in application recovery mode. |
Remarks
This API is for applications that have multiple processes interacting with each other. An application's main process would register the Id of another process. When the registering process crashes, WER will add an additional triage dump of the registered process to the resulting diagnostics. Optionally, the registering process can provide a thread Id as well to get more data for that specific thread.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 1703 [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2016 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | werapi.h |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |