Funzione WerRegisterAdditionalProcess (werapi.h)

Registra un processo da includere nel report Segnalazione errori Windows (WER) insieme al processo principale dell'applicazione. Facoltativamente specifica un thread all'interno del processo registrato per ottenere dati aggiuntivi da.

Sintassi

HRESULT WerRegisterAdditionalProcess(
             DWORD processId,
  [optional] DWORD captureExtraInfoForThreadId
);

Parametri

processId

ID del processo da registrare.

[optional] captureExtraInfoForThreadId

ID di un thread all'interno del processo registrato da cui sono richieste altre informazioni.

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	Il valore di processId è 0.
E_OUTOFMEMORY	Non è stato possibile allocare un heap sufficiente per i dati.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Il numero di voci registrate di WER (blocchi di memoria, metadati, file) supera il numero massimo (WER_MAX_REGISTERED_ENTRIES) o il numero di processi supera il massimo (WER_MAX_REGISTERED_DUMPCOLLECTION)
WER_E_INVALID_STATE	Lo stato del processo non è valido. Ad esempio, il processo è in modalità di ripristino dell'applicazione.

Commenti

Questa API è per le applicazioni con più processi che interagiscono tra loro. Il processo principale di un'applicazione registra l'ID di un altro processo. Quando il processo di registrazione si arresta in modo anomalo, WER aggiungerà un dump di valutazione aggiuntivo del processo registrato alla diagnostica risultante. Facoltativamente, il processo di registrazione può fornire un ID thread e ottenere altri dati per tale thread specifico.

Requisiti

Requisito	Valore
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

WerUnregisterAdditionalProcess, Segnalazione errori Windows