INetDiagHelper::GetAttributes-Methode (ndhelper.h)

Artikel
03/04/2024

Die GetAttributes-Methode ruft zusätzliche Informationen zu einem Problem ab, das von der Hilfsklassenerweiterung diagnostiziert wurde.

Syntax

HRESULT GetAttributes(
  [out] ULONG            *pcelt,
  [out] HELPER_ATTRIBUTE **pprgAttributes
);

Parameter

[out] pcelt

Ein Zeiger auf die Anzahl der Elemente im HELPER_ATTRIBUTE Arrays.

[out] pprgAttributes

Ein Zeiger auf ein Array von HELPER_ATTRIBUTE Strukturen.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar, um diesen Vorgang abzuschließen.
E_INVALIDARG	Mindestens ein Parameter wurde nicht ordnungsgemäß bereitgestellt.
E_NOTIMPL	Diese optionale Methode ist nicht implementiert.
E_ACCESSDENIED	Der Aufrufer verfügt nicht über ausreichende Berechtigungen, um den Diagnose- oder Reparaturvorgang auszuführen.
E_ABORT	Die Diagnose oder der Reparaturvorgang wurde abgebrochen.

Hilfsklassenerweiterungen können HRESULTS zurückgeben, die für die in der Funktion aufgetretenen Fehler spezifisch sind.

Hinweise

Diese Methode ist beim Erstellen einer Hilfsklassenerweiterung nicht erforderlich.

Während des Diagnose- und Reparaturprozesses kann eine Hilfsklasse optional Attribute an NDF zurückgeben, die die Behandlung der Diagnose durch die NDF verbessern. Die vordefinierten Attribute, die an die NDF zurückgegeben werden können, lauten wie folgt.

Begriff	BESCHREIBUNG
werperameter (Typ: AT_UINT32)	Wenn die Diagnose fehlschlägt, ein optionales Attribut für zusätzliche hilfsklassenspezifische Windows-Fehlerberichterstattung (WER)-Bucketingparameter.
werfile (Typ: AT_STRING)	Ein optionales Attribut zum Hinzufügen klassenspezifischer Hilfsdateien zu Windows-Fehlerberichterstattung -Berichten (WER).
rootcauseid (Typ: AT_GUID)	Hilfsklassen können häufig mehrere Probleme gleichzeitig diagnostizieren. Die Analyse des aufgetretenen Problems kann in NDF verbessert werden, wenn die Erweiterung ein HelperAttribute vom Typ AT_GUID zurückgibt, wobei der pszName-Parameter auf rootcauseid und das Guid-Feld auf eine GUID festgelegt ist, die das spezifische Problem identifiziert. Diese GUIDs werden von der Hilfserweiterung benutzerdefinierten.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ndhelper.h

Weitere Informationen

INetDiagHelper

Freigeben über