Función WerRegisterMemoryBlock (werapi.h)

  • Artículo

Registra un bloque de memoria que se va a recopilar cuando Informe de errores de Windows (WER) crea un informe de errores.

Sintaxis

HRESULT WerRegisterMemoryBlock(
  [in] PVOID pvAddress,
  [in] DWORD dwSize
);

Parámetros

[in] pvAddress

Dirección inicial del bloque de memoria.

[in] dwSize

Tamaño del bloque de memoria, en bytes. El valor máximo de este parámetro es WER_MAX_MEM_BLOCK_SIZE bytes.

Valor devuelto

Esta función devuelve S_OK si se ha realizado correctamente o un código de error en caso de error, incluidos los siguientes códigos de error.

Código devuelto Descripción
WER_E_INVALID_STATE El estado del proceso no es válido. Por ejemplo, el proceso está en modo de recuperación de aplicaciones.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) El número de bloques de memoria registrados y archivos supera el límite.

Comentarios

La memoria registrada con esta función solo se agrega al montón o a archivos de volcado de memoria más grandes. Esta memoria nunca se agrega a mini volcados o archivos de volcado más pequeños.

Para bloqueos y sin respuesta, el sistema operativo proporciona automáticamente informes de errores (no es necesario proporcionar ningún código de informe de errores en la aplicación). Si usa esta función para registrar un bloque de memoria, el sistema operativo agregará la información del bloque de memoria al archivo de volcado en el momento del bloqueo o no respuesta. El bloque de memoria se agrega al archivo de volcado del informe solo cuando el servidor solicita datos adicionales.

En el caso de los informes de eventos genéricos, la aplicación tiene que llamar directamente a las funciones de informes de eventos genéricos de WER. Para agregar el bloque de memoria a un informe genérico, llame a la función WerReportAddDump y, a continuación, llame a la función WerReportSubmit y especifique la marca WER_SUBMIT_ADD_REGISTERED_DATA.

Para quitar el bloque de esta lista, llame a la función WerUnregisterMemoryBlock .

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado werapi.h
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

WerUnregisterMemoryBlock, Informe de errores de Windows