INetDiagHelper::GetLifeTime method (ndhelper.h)

The GetLifeTime method retrieves the lifetime of the Helper Class Extension instance.


HRESULT GetLifeTime(
  [out] LIFE_TIME *pLifeTime


[out] pLifeTime

A pointer to a LIFE_TIME structure.

Return value

Return code Description
The operation succeeded.
There is not enough memory available to complete this operation.
One or more parameters has not been provided correctly.
This optional method is not implemented.
The caller does not have sufficient privileges to perform the diagnosis or repair operation.
The diagnosis or repair operation has been canceled.

Helper Class Extensions may return HRESULTS that are specific to the failures encountered in the function.


This method is not required when building a Helper Class Extension.

Lifetime data is used to limit the time scope of a problem instance. This is particularly useful when doing history-based diagnoses such as tracing and logging where it can be used in scoping down the diagnosis to events that occurred during the specified time interval.

For example, Windows Filtering Platform (WFP) helper classes use lifetime to determine which filter blocked a packet by checking the trace log. By default, a lifetime of a helper class instance inherits the lifetime of its dependent helper class instance.


Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header ndhelper.h

See also