Méthode INetDiagHelper ::GetLifeTime (ndhelper.h)
La méthode GetLifeTime récupère la durée de vie de l’extension de classe Helper instance.
Syntaxe
HRESULT GetLifeTime(
[out] LIFE_TIME *pLifeTime
);
Paramètres
[out] pLifeTime
Pointeur vers une structure LIFE_TIME .
Valeur retournée
| Code de retour | Description |
|---|---|
|
L’opération a réussi. |
|
La mémoire disponible est insuffisante pour effectuer cette opération. |
|
Un ou plusieurs paramètres n’ont pas été fournis correctement. |
|
Cette méthode facultative n’est pas implémentée. |
|
L’appelant ne dispose pas des privilèges suffisants pour effectuer l’opération de diagnostic ou de réparation. |
|
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 obligatoire lors de la création d’une extension de classe d’assistance.
Les données de durée de vie sont utilisées pour limiter l’étendue du temps d’un problème instance. Cela est particulièrement utile lorsque vous effectuez des diagnostics basés sur l’historique, tels que le suivi et la journalisation, où ils peuvent être utilisés pour définir l’étendue du diagnostic en fonction des événements qui se sont produits pendant l’intervalle de temps spécifié.
Par exemple, les classes d’assistance de la plateforme de filtrage Windows (PAM) utilisent la durée de vie pour déterminer quel filtre a bloqué un paquet en vérifiant le journal de trace. Par défaut, une durée de vie d’une classe d’assistance instance hérite de la durée de vie de sa classe d’assistance dépendante instance.
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 |