Функция 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