WerReportSetParameter-Funktion (werapi.h)

Artikel
07/27/2023

Legt die Parameter fest, die ein Ereignis für den angegebenen Windows-Fehlerberichterstattung-Bericht (WER) eindeutig identifizieren.

Syntax

HRESULT WerReportSetParameter(
  [in]           HREPORT hReportHandle,
  [in]           DWORD   dwparamID,
  [in, optional] PCWSTR  pwzName,
  [in]           PCWSTR  pwzValue
);

Parameter

[in] hReportHandle

Ein Handle für den Bericht. Dieses Handle wird von der Funktion WerReportCreate zurückgegeben.

[in] dwparamID

Der Bezeichner des festzulegenden Parameters. Dieser Parameter kann einen der folgenden Werte annehmen.

WER_P0
WER_P1
WER_P2
WER_P3
WER_P4
WER_P5
WER_P6
WER_P7
WER_P8
WER_P9

[in, optional] pwzName

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Parameters enthält. Wenn dieser Parameter NULL ist, lautet der Standardname Px, wobei x mit dem ganzzahligen Teil des in dwparamID angegebenen Werts übereinstimmt.

[in] pwzValue

Der Parameterwert.

Rückgabewert

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

Rückgabecode	Beschreibung
E_HANDLE	Der angegebene Handle ist ungültig.
WER_E_LENGTH_EXCEEDED	Die Länge eines oder mehrerer Zeichenfolgenargumente hat ihren Grenzwert überschritten.

Bemerkungen

Jeder Bericht unterstützt die Parameter P0 bis P9. Diese Funktion legt jeweils einen Parameter fest. Wenn der Parameter Px festgelegt ist, müssen alle Parameter von P0 und Px festgelegt werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	werapi.h
Bibliothek	Wer.lib
DLL	Wer.dll

Weitere Informationen

WerReportCreate, Windows-Fehlerberichterstattung

Share via