Функция WerRegisterMemoryBlock (werapi.h)

  • Статья

Регистрирует блок памяти для сбора, когда отчеты об ошибках Windows (WER) создает отчет об ошибках.

Синтаксис

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

Параметры

[in] pvAddress

Начальный адрес блока памяти.

[in] dwSize

Размер блока памяти в байтах. Максимальное значение для этого параметра — WER_MAX_MEM_BLOCK_SIZE байтов.

Возвращаемое значение

Эта функция возвращает S_OK об успешном выполнении или код ошибки при сбое, включая следующие коды ошибок.

Код возврата Описание
WER_E_INVALID_STATE Недопустимое состояние процесса. Например, процесс находится в режиме восстановления приложения.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) Количество зарегистрированных блоков памяти и файлов превышает ограничение.

Комментарии

Память, зарегистрированная с помощью этой функции, добавляется только в кучу или большие файлы дампа. Эта память никогда не добавляется в мини-дампы или файлы дампов меньшего размера.

При сбоях и отсутствии ответа операционная система автоматически предоставляет отчеты об ошибках (вам не нужно предоставлять код отчета об ошибках в приложении). Если эта функция используется для регистрации блока памяти, операционная система добавит сведения о блоке памяти в файл дампа во время сбоя или без ответа. Блок памяти добавляется в файл дампа отчета только в том случае, если сервер запрашивает дополнительные данные.

Для создания отчетов об универсальных событиях приложение должен напрямую вызывать универсальные функции отчетов о событиях WER. Чтобы добавить блок памяти в универсальный отчет, вызовите функцию WerReportAddDump , а затем вызовите функцию WerReportSubmit и укажите флаг WER_SUBMIT_ADD_REGISTERED_DATA.

Чтобы удалить блок из этого списка, вызовите функцию WerUnregisterMemoryBlock .

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header werapi.h
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

WerUnregisterMemoryBlock, отчеты об ошибках Windows