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