Compartilhar via

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

  • Last updated on