Dell Intel PRO Family of Adapters - Manuel (Page 16)

Retour à la table des matières
Rapports d'erreurs : Guide de l'utilisateur des fournisseurs WMI et
CDM pour cartes réseau Intel® PRO
Présentation
Codes d'erreur
Présentation
La section suivante, relative à IANet_ExtendedStatus, explique comment traiter les erreurs générées par les fournisseurs WMI et
CDM. Le moment et la manière dont une erreur est renvoyée dépend de l'état synchrone, semi-synchrone ou asynchrone d'un
appel. Dans la plupart des cas, HRESULT est défini sur WBEM_E_FAILED lorsqu'une erreur se produit. À ce stade cependant, il
est impossible de savoir si l'erreur a été générée par WMI ou par les fournisseurs.
Pour obtenir l'objet de l'erreur dans le cas d'appels synchrones, utilisez GetErrorInfo() pour obtenir l'objet IErrorInfo. Utilisez
QueryInterface() pour obtenir IWbemClassObject contenant les informations sur l'erreur.
Pour obtenir l'objet de l'erreur dans le cas d'appels asynchrones, IWbemClassObject est renvoyé en dernier lors du dernier appel
SetStatus(). Après avoir obtenu l'instance de l'objet de l'erreur, vous pouvez vérifier la propriété __Class pour déterminer l'origine
de l'erreur. WMI crée une instance de __ExtendedStatus, et les fournisseurs créent une instance de IANet_ExtendedStatus pour
les erreurs associées à IANet_ classes. IANet_ExtendedStatus est dérivé de __ExtendedStatus et contient les qualificateurs d'objet
d'erreur suivants :
Description – Description de l'erreur en fonction des paramètres régionaux actuels.
File – Fichier code dans lequel l'erreur a été générée.
Line – Numéro de ligne du fichier code dans laquelle l'erreur s'est produite.
ParameterInfo – Classe ou attribut utilisé lorsque l'erreur s'est produite.
Operation – Opération tentée lorsque l'erreur s'est produite.
ProviderName – Nom du fournisseur ayant causé l'erreur.
StatusCode – Code renvoyé depuis l'appel interne qui a échoué.
SessionHandle – Descripteur de session utilisé pour l'opération.
RuleFailureReasons – Raison de l'échec de l'opération. Une opération peut échouer suite à l'échec d'une règle technique.
(P. ex., vous devez disposer d'une carte de gestion dans certaines associations.)
Retour au début de la page
Codes d'erreur
Pour tous les codes d'erreur, les fournisseurs donnent une description personnalisée sur base des paramètres régionaux. Les
codes d'erreur sont sous la forme de HRESULT avec une sévérité 1 et une facilité ITF. Une application peut utiliser les codes
suivants comme base pour une action de récupération :
0x80040901 – "WMI: Put property failed" (Échec de l'application de la propriété)
0x80040902 – "WMI: No class object" (Pas d'objet de classe)
0x80040903 – "WMI: Failed to create class" (Imposible de créer la classe)
0x80040904 – "WMI: Failed to spawn instance of class" (Impossible de générer une instance de classe)
0x80040905 – "WMI: Failed to create safe array" (Impossible de créer une zone de sécurité)
0x80040906 – "WMI: Failed to put safe array" (Impossible de placer une zone de sécurité)
0x80040907 – "WMI: Failed to return object to WMI" (Impossible de retourner l'objet à WMI)
0x80040908 – "WMI: Get property failed" (Échec de l'obtention de la propriété)
0x80040909 – "WMI: Unexpected type while getting property" (Type inattendu lors de l'obtention de la propriété)
0x8004090A – "WMI: Class not implemented by this provider" (Classe non mise en oeuvre par ce fournisseur)
0x8004090B – "WMI: Unable to parse WQL statement" (Impossible d'analyser le langage de la requête WQL)
0x8004090C – "WMI: Providers only support WQL" (Le fournisseur ne prend en charge que le langage WQL)
16