WerRegisterAdditionalProcess-Funktion (werapi.h)

Registriert einen Prozess, der zusammen mit dem Standard-Antragsprozess in den Windows-Fehlerberichterstattung-Bericht (WER) aufgenommen werden soll. Gibt optional einen Thread innerhalb dieses registrierten Prozesses an, aus dem zusätzliche Daten abgerufen werden sollen.

Syntax

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

Parameter

processId

Die ID des zu registrierenden Prozesses.

[optional] captureExtraInfoForThreadId

Die ID eines Threads innerhalb des registrierten Prozesses, von dem weitere Informationen angefordert werden.

Rückgabewert

Diese Funktion gibt S_OK bei Erfolg oder einen Fehlercode bei Fehler zurück, einschließlich der folgenden Fehlercodes.

Rückgabecode	Beschreibung
E_INVALIDARG	Der Wert von processId ist 0.
E_OUTOFMEMORY	WER konnte keinen ausreichend großen Heap für die Daten zuordnen.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	Die Anzahl der registrierten WER-Einträge (Speicherblöcke, Metadaten, Dateien) überschreitet max (WER_MAX_REGISTERED_ENTRIES) oder die Anzahl der Prozesse überschreitet max (WER_MAX_REGISTERED_DUMPCOLLECTION)
WER_E_INVALID_STATE	Der Prozessstatus ist ungültig. Der Prozess befindet sich beispielsweise im Anwendungswiederherstellungsmodus.

Hinweise

Diese API ist für Anwendungen vorgesehen, bei denen mehrere Prozesse miteinander interagieren. Der Standard Prozess einer Anwendung würde die ID eines anderen Prozesses registrieren. Wenn der Registrierungsprozess abstürzt, fügt WER dem resultierenden Diagnose ein zusätzliches Triagedump des registrierten Prozesses hinzu. Optional kann der Registrierungsprozess auch eine Thread-ID bereitstellen, um weitere Daten für diesen bestimmten Thread abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1703 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	werapi.h
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

WerUnregisterAdditionalProcess, Windows-Fehlerberichterstattung