Função WerRegisterMemoryBlock (werapi.h)
Registra um bloco de memória a ser coletado quando Relatório de Erros do Windows (WER) cria um relatório de erros.
Sintaxe
HRESULT WerRegisterMemoryBlock(
[in] PVOID pvAddress,
[in] DWORD dwSize
);
Parâmetros
[in] pvAddress
O endereço inicial do bloco de memória.
[in] dwSize
O tamanho do bloco de memória, em bytes. O valor máximo para esse parâmetro é WER_MAX_MEM_BLOCK_SIZE bytes.
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 estado do processo não é válido. Por exemplo, o processo está no modo de recuperação de aplicativo. |
| HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | O número de arquivos e blocos de memória registrados excede o limite. |
Comentários
A memória registrada com essa função só é adicionada a arquivos de despejo maiores ou heap. Essa memória nunca é adicionada a mini despejos ou arquivos de despejo menores.
Para falhas e nenhuma resposta, o sistema operacional fornece automaticamente relatórios de erros (você não precisa fornecer nenhum código de relatório de erros em seu aplicativo). Se você usar essa função para registrar um bloco de memória, o sistema operacional adicionará as informações de bloco de memória ao arquivo de despejo no momento da falha ou não resposta. O bloco de memória é adicionado ao arquivo de despejo para o relatório somente quando dados adicionais são solicitados pelo servidor.
Para relatórios de eventos genéricos, o aplicativo precisa chamar as funções de relatório de eventos genéricos do WER diretamente. Para adicionar o bloco de memória a um relatório genérico, chame a função WerReportAddDump e, em seguida, chame a função WerReportSubmit e especifique o sinalizador WER_SUBMIT_ADD_REGISTERED_DATA.
Para remover o bloco dessa lista, chame a função WerUnregisterMemoryBlock .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | werapi.h |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |