INetDiagHelper::GetLifeTime 方法 (ndhelper.h)
GetLifeTime 方法會擷取 Helper 類別擴充實例的存留期。
語法
HRESULT GetLifeTime(
[out] LIFE_TIME *pLifeTime
);
參數
[out] pLifeTime
LIFE_TIME 結構的指標。
傳回值
傳回碼 | 描述 |
---|---|
|
作業成功。 |
|
記憶體不足,無法完成此作業。 |
|
尚未正確提供一或多個參數。 |
|
未實作這個選擇性方法。 |
|
呼叫端沒有足夠的許可權可執行診斷或修復作業。 |
|
診斷或修復作業已取消。 |
協助程式類別延伸模組可能會傳回函式中發生失敗的特定 HRESULTS。
備註
建置 Helper 類別延伸模組時不需要這個方法。
存留期數據用來限制問題實例的時間範圍。 這在進行以歷程記錄為基礎的診斷時特別有用,例如追蹤和記錄,可用於將診斷範圍縮小為在指定時間間隔內發生的事件。
例如,Windows 篩選平臺 (一個一開始) 協助程序類別會使用存留期,藉由檢查追蹤記錄來判斷哪一個篩選封鎖了封包。 根據預設,協助程式類別實例的存留期會繼承其相依協助程序類別實例的存留期。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | ndhelper.h |