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 |