Fehlermeldungen, Überblick, Fehlercodes – Dell Intel PRO Family of Adapters Benutzerhandbuch
Seite 17
Fehlermeldungen: Benutzerhandbuch für Intel® PRO
Netzwerkadapter – WMI und CDM Provider
Überblick
In diesem Abschnitt über IANet_ExtendedStatus wird beschrieben, wie Sie mit Fehlern umgehen, die von WMI und CDM Provider
generiert werden. Auf welche Weise und wann ein Fehlerobjekt zurückgegeben wird, hängt davon ab, ob ein Aufruf synchron,
semi-synchron oder asynchron erfolgt. In den meisten Fällen ist HRESULT bei Auftreten eines Fehler auf WBEM_E_FAILED
eingestellt. Zu diesem Zeitpunkt ist jedoch nicht bekannt, ob WMI oder die Provider den Fehler generiert haben.
Verwenden Sie bei synchronen Aufrufen GetErrorInfo(), um das IErrorInfo-Objekt zu ermitteln. Verwenden Sie QueryInterface(), um
das IWbemClassObject zu erhalten, das die Fehlerinformationen enthält.
Bei asynchronen Aufrufen wird das Fehlerobjekt als IWbemClassObject zurückgegeben. Es ist das letzte Element im letzten
SetStatus()-Aufruf. Nachdem Sie die Fehlerobjekt-Instanz ermittelt haben, können Sie die __Class-Eigenschaft überprüfen, um den
Ursprung des Fehlers zu bestimmen. WMI erstellt eine Instanz von __ExtendedStatus, und die Provider erstellen eine Instanz von
IANet_ExtendedStatus für Fehler, die mit IANet_ classes zusammenhängen. IANet_ExtendedStatus wird von __ExtendedStatus
abgeleitet und enthält die folgenden Fehlerobjekt-Qualifizierungsmerkmale:
Description – Beschreibung des Fehlers, die auf den aktuellen Standort zugeschnitten ist.
File – Codedatei, in der der Fehler generiert wurde.
Line – Nummer der Zeile, in der sich der Fehler in der Codedatei befindet.
ParameterInfo – Klasse bzw. Attribut, die bzw. das verwendet wurde, als der Fehler auftrat.
Operation – Vorgang, bei dessen versuchter Ausführung der Fehler auftrat.
ProviderName – Name des Providers, der den Fehler verursacht hat.
StatusCode – Code, der vom internen fehlgeschlagenen Aufruf zurückgegeben wurde.
SessionHandle – Sitzungshandle, das für den Vorgang verwendet wurde.
RuleFailureReasons – Grund für das Versagen des Vorgangs. Ein Vorgang kann fehlschlagen, weil eine technische Regel
versagt hat (bei bestimmten Gruppen benötigen Sie z. B. einen Verwaltungsadapter).
Fehlercodes
Für alle Fehlercodes geben die Provider eine Beschreibung aus, die auf den jeweiligen Standort zugeschnitten ist. Fehlercodes
werden im Format HRESULT angegeben, wobei der Schweregrad auf 1 und die Fähigkeit auf ITF eingestellt sind. Eine Anwendung
kann die folgenden Codes als Basis für eine Wiederherstellungsaktion verwenden:
0x80040901 – "WMI: Put property failed" (WMI: Put-Eigenschaft fehlgeschlagen)
0x80040902 – "WMI: No class object" (WMI: Kein Klassenobjekt)
0x80040903 – "WMI: Failed to create class" (WMI: Klasse konnte nicht erstellt werden)
0x80040904 – "WMI: Failed to spawn instance of class" (WMI: Instanz der Klasse konnte nicht erzeugt werden)
0x80040905 – "WMI: Failed to create safe array" (WMI: Sicheres Array konnte nicht erstellt werden)
0x80040906 – "WMI: Failed to create safe array" (WMI: Sicheres Array konnte nicht platziert werden)
0x80040907 – "WMI: Failed to return object to WMI" (WMI: Objekt konnte nicht an WMI zurückgegeben werden)
0x80040908 – "WMI: Put property failed" (WMI: Get-Eigenschaft fehlgeschlagen)
0x80040909 – "WMI: Unexpected type while getting property" (WMI: Unerwarteter Typ beim Ermitteln der Eigenschaft)
0x8004090A – "WMI: Class not implemented by this provider" (WMI: Klasse wurde von diesem Provider nicht implementiert)
0x8004090B – "WMI: Unable to parse WQL statement" (WMI: WQL-Aussage konnte nicht analysiert werden)
0x8004090C – "WMI: Providers only support WQL" (WMI: Provider unterstützen nur WQL)
17