INetDiagHelper::GetLifeTime 方法 (ndhelper.h)

GetLifeTime 方法检索帮助程序类扩展实例的生存期。

语法

HRESULT GetLifeTime(
  [out] LIFE_TIME *pLifeTime
);

参数

[out] pLifeTime

指向 LIFE_TIME 结构的指针。

返回值

返回代码 说明
S_OK
操作成功。
E_OUTOFMEMORY
没有足够的内存可用于完成此操作。
E_INVALIDARG
未正确提供一个或多个参数。
E_NOTIMPL
此可选方法未实现。
E_ACCESSDENIED
调用方没有足够的权限来执行诊断或修复操作。
E_ABORT
诊断或修复操作已取消。
 

帮助程序类扩展可能会返回特定于函数中遇到的故障的 HRESULTS。

注解

生成帮助程序类扩展时不需要此方法。

生存期数据用于限制问题实例的时间范围。 这在进行基于历史记录的诊断(例如跟踪和日志记录)时特别有用,这些诊断可用于将诊断范围缩小到指定时间间隔内发生的事件。

例如,Windows 筛选平台 (WFP) 帮助程序类使用生存期通过检查跟踪日志来确定阻止数据包的筛选器。 默认情况下,帮助程序类实例的生存期继承其依赖帮助程序类实例的生存期。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 ndhelper.h

另请参阅

INetDiagHelper