Função WerRegisterAdditionalProcess (werapi.h)

Registra um processo a ser incluído no relatório Relatório de Erros do Windows (WER) juntamente com o processo de aplicativo main. Opcionalmente, especifica um thread dentro desse processo registrado para obter dados adicionais.

Sintaxe

HRESULT WerRegisterAdditionalProcess(
             DWORD processId,
  [optional] DWORD captureExtraInfoForThreadId
);

Parâmetros

processId

A ID do processo a ser registrado.

[optional] captureExtraInfoForThreadId

A ID de um thread dentro do processo registrado do qual mais informações são solicitadas.

Retornar valor

Essa função retorna S_OK com êxito ou um código de erro em caso de falha, incluindo os seguintes códigos de erro.

Código de retorno	Descrição
E_INVALIDARG	O valor de processId é 0.
E_OUTOFMEMORY	O WER não pôde alocar um heap grande o suficiente para os dados.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	O número de entradas registradas no WER (blocos de memória, metadados, arquivos) excede o máximo (WER_MAX_REGISTERED_ENTRIES) ou o número de processos excede o máximo (WER_MAX_REGISTERED_DUMPCOLLECTION)
WER_E_INVALID_STATE	O estado do processo não é válido. Por exemplo, o processo está no modo de recuperação de aplicativo.

Comentários

Essa API é para aplicativos que têm vários processos interagindo entre si. O processo de main de um aplicativo registraria a ID de outro processo. Quando o processo de registro falhar, o WER adicionará um despejo de triagem adicional do processo registrado à diagnóstico resultante. Opcionalmente, o processo de registro também pode fornecer uma ID de thread para obter mais dados para esse thread específico.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10, versão 1703 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2016 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	werapi.h
Biblioteca	Kernel32.lib
DLL	Kernel32.dll

Confira também

WerUnregisterAdditionalProcess, Relatório de Erros do Windows