Compartilhar via

Função WerRegisterAppLocalDump (werapi.h)

  • Artigo

Registra um caminho (em relação à LocalFolder do aplicativo empacotado) em que uma cópia deve ser salva do despejo de memória de diagnóstico que Relatório de Erros do Windows (WER) coleta quando um dos processos do aplicativo para de responder.

Sintaxe

HRESULT WerRegisterAppLocalDump(
  [in] PCWSTR localAppDataRelativePath
);

Parâmetros

[in] localAppDataRelativePath

O caminho relativo à loja de aplicativos local para o aplicativo de chamada. É aí que uma cópia é salva do despejo de memória de diagnóstico que o WER coleta quando um dos processos do aplicativo para de responder. O comprimento máximo para esse caminho relativo em caracteres é WER_MAX_LOCAL_DUMP_SUBPATH_LENGTH, que tem um valor de 64. Esse comprimento máximo inclui o caractere de terminação nula.

Retornar valor

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

Código de retorno Descrição
WER_E_INVALID_STATE O processo não pode armazenar o despejo de memória ou o WER não pode criar um local para armazenar o despejo de memória.
E_INVALIDARG O parâmetro localAppDataRelativePath é NULL ou tem mais de 64 caracteres.

Comentários

Um aplicativo empacotado chama WerRegisterAppLocalDump quando o aplicativo é iniciado para solicitar uma cópia do despejo de memória de diagnóstico que o WER coleta se ou quando um dos processos do aplicativo para de responder.

O WER não gerencia o armazenamento no local que o caminho relativo especifica ou o número de despejos de memória coletados para o aplicativo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1709 [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 KernelBase.dll

Confira também

Função WerUnregisterAppLocalDump, Relatório de Erros do Windows