Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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