Fonction WerRegisterAdditionalProcess (werapi.h)

Article
07/27/2023

Inscrit un processus à inclure dans le rapport Rapport d'erreurs Windows (WER) ainsi que le processus d’application main. Spécifie éventuellement un thread dans ce processus inscrit à partir duquel obtenir des données supplémentaires.

Syntaxe

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

Paramètres

processId

ID du processus à inscrire.

[optional] captureExtraInfoForThreadId

ID d’un thread dans le processus inscrit à partir duquel des informations supplémentaires sont demandées.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite ou un code d’erreur en cas d’échec, y compris les codes d’erreur suivants.

Code de retour	Description
E_INVALIDARG	La valeur de processId est 0.
E_OUTOFMEMORY	WER n’a pas pu allouer un tas suffisamment grand pour les données.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Le nombre d’entrées enregistrées par wer (blocs de mémoire, métadonnées, fichiers) dépasse le nombre maximal (WER_MAX_REGISTERED_ENTRIES) ou le nombre de processus dépasse la valeur maximale (WER_MAX_REGISTERED_DUMPCOLLECTION)
WER_E_INVALID_STATE	L’état du processus n’est pas valide. Par exemple, le processus est en mode de récupération d’application.

Remarques

Cette API est destinée aux applications qui ont plusieurs processus qui interagissent les uns avec les autres. Le processus main d’une application enregistre l’ID d’un autre processus. Lorsque le processus d’inscription se bloque, WER ajoute un vidage de triage supplémentaire du processus inscrit au diagnostics résultant. Si vous le souhaitez, le processus d’inscription peut également fournir un ID de thread pour obtenir plus de données pour ce thread spécifique.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1703 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2016 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	werapi.h
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

WerUnregisterAdditionalProcess, Rapport d'erreurs Windows

Share via