Funzione WerRegisterExcludedMemoryBlock (werapi.h)

Articolo
10/28/2023

Contrassegna un blocco di memoria (normalmente incluso per impostazione predefinita nei report degli errori) da escludere dal report di errore Segnalazione errori Windows (WER).

Sintassi

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

Parametri

address

Indirizzo iniziale del blocco di memoria.

size

Dimensioni del blocco di memoria, in byte.

Valore restituito

Questa funzione restituisce S_OK in caso di esito positivo o in caso di errore, inclusi i codici di errore seguenti.

Codice restituito	Descrizione
E_INVALIDARG	l'indirizzo è NULL o dimensioni pari a 0.
E_OUTOFMEMORY	WeR non è riuscito a allocare un heap sufficiente per i dati
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Il numero di voci registrate supera il limite (WER_MAX_REGISTERED_ENTRIES).
WER_E_INVALID_STATE	Lo stato del processo non è valido. Ad esempio, il processo è in modalità di ripristino dell'applicazione.

Commenti

Questo meccanismo è destinato alle applicazioni che contengono grandi quantità di dati in memoria che non sono utili per il debug della causa radice e aumentare le dimensioni del file di dump inutilmente. Ad esempio, alcuni giochi contengono grandi quantità di dati di trama in memoria inclusi nei dump degli errori per impostazione predefinita.

Requisiti


Client minimo supportato	Windows 10, versione 1703 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2016 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	werapi.h
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

WerUnregisterExcludedMemoryBlock, Segnalazione errori Windows

Condividi tramite