INetDiagHelper ::GetAttributes, méthode (ndhelper.h)

Article
02/29/2024

La méthode GetAttributes récupère des informations supplémentaires sur un problème que l’extension de classe d’assistance a diagnostiqué.

Syntaxe

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

Paramètres

[out] pcelt

Pointeur vers un nombre d’éléments dans le tableau HELPER_ATTRIBUTE .

[out] pprgAttributes

Pointeur vers un tableau de structures HELPER_ATTRIBUTE .

Valeur retournée

Code de retour	Description
S_OK	L’opération a réussi.
E_OUTOFMEMORY	La mémoire disponible est insuffisante pour effectuer cette opération.
E_INVALIDARG	Un ou plusieurs paramètres n’ont pas été fournis correctement.
E_NOTIMPL	Cette méthode facultative n’est pas implémentée.
E_ACCESSDENIED	L’appelant ne dispose pas des privilèges suffisants pour effectuer l’opération de diagnostic ou de réparation.
E_ABORT	L’opération de diagnostic ou de réparation a été annulée.

Les extensions de classe d’assistance peuvent retourner des HRESULTS spécifiques aux échecs rencontrés dans la fonction.

Remarques

Cette méthode n’est pas requise lors de la création d’une extension de classe d’assistance.

Pendant le processus de diagnostic et de réparation, une classe d’assistance peut éventuellement retourner des attributs à NDF qui améliorent la gestion du diagnostic par NDF. Les attributs prédéfinis qui peuvent être retournés à NDF sont les suivants.

Terme	Description
werperameter (Type : AT_UINT32)	En cas d’échec du diagnostic, attribut facultatif pour le paramètre de compartimentage Rapport d'erreurs Windows wer (WER) spécifique à la classe d’assistance supplémentaire.
werfile (Type : AT_STRING)	Attribut facultatif permettant d’ajouter des fichiers spécifiques à la classe d’assistance aux rapports Rapport d'erreurs Windows (WER).
rootcauseid (Type : AT_GUID)	Les classes d’assistance peuvent souvent diagnostiquer plusieurs problèmes à la fois. L’analyse du problème rencontré peut être améliorée dans NDF si l’extension retourne un HelperAttribute de type AT_GUID avec le paramètre pszName défini sur rootcauseid et le champ Guid défini sur un GUID identifiant le problème spécifique rencontré. Ces GUID sont personnalisés définis par l’extension d’assistance.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ndhelper.h

Voir aussi

INetDiagHelper

Partager via