WerRegisterExcludedMemoryBlock 関数 (werapi.h)

メモリブロック (通常はエラーレポートに既定で含まれる) をWindows エラー報告 (WER) エラーレポートから除外するようにマークします。

構文

HRESULT WerRegisterExcludedMemoryBlock(
  const void *address,
  DWORD      size
);

address

メモリブロックの開始アドレス。

size

メモリブロックのサイズ (バイト単位)。

この関数は、成功 した場合はS_OK 、失敗した場合は次のエラーコードを含むエラーコードを返します。

リターンコード	説明
E_INVALIDARG	address が NULL であるか、サイズが 0 です。
E_OUTOFMEMORY	WER でデータに十分な大きさのヒープを割り当てられなかった
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	登録されたエントリの数が制限 (WER_MAX_REGISTERED_ENTRIES) を超えています。
WER_E_INVALID_STATE	プロセスの状態が無効です。たとえば、プロセスはアプリケーション回復モードです。

このメカニズムは、根本原因のデバッグに役立たない大量のデータをメモリに保持し、ダンプファイルのサイズを不必要に大きくするアプリケーションを対象としています。たとえば、一部のゲームでは、既定でエラーダンプに含まれる大量のテクスチャデータがメモリに保持されます。


サポートされている最小のクライアント	Windows 10 バージョン 1703 [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2016 [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	werapi.h
Library	Kernel32.lib
[DLL]	Kernel32.dll