Partager via


Fonction WerRegisterAdditionalProcess (werapi.h)

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