INetDiagHelper::GetLifeTime-Methode (ndhelper.h)

Die GetLifeTime-Methode ruft die Lebensdauer der Hilfsklassenerweiterung instance ab.

Syntax

HRESULT GetLifeTime(
  [out] LIFE_TIME *pLifeTime
);

Parameter

[out] pLifeTime

Ein Zeiger auf eine LIFE_TIME Struktur.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_OUTOFMEMORY	Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar.
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 geben möglicherweise HRESULTS zurück, die spezifisch für die In der Funktion aufgetretenen Fehler sind.

Hinweise

Diese Methode ist beim Erstellen einer Hilfsklassenerweiterung nicht erforderlich.

Lebensdauerdaten werden verwendet, um den Zeitbereich eines Problems instance einzuschränken. Dies ist besonders nützlich, wenn verlaufsbasierte Diagnosen wie Ablaufverfolgung und Protokollierung durchgeführt werden, bei denen die Diagnose auf Ereignisse eingegrenzt werden kann, die während des angegebenen Zeitintervalls aufgetreten sind.

Beispielsweise verwenden WFP-Hilfsklassen (Windows Filtering Platform) die Lebensdauer, um zu bestimmen, welcher Filter ein Paket blockiert, indem das Ablaufverfolgungsprotokoll überprüft wird. Standardmäßig erbt eine Lebensdauer einer Hilfsklasse instance die Lebensdauer der abhängigen Hilfsklasse instance.

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