INetDiagHelper::GetLifeTime メソッド (ndhelper.h)

GetLifeTime メソッドは、ヘルパークラス拡張インスタンスの有効期間を取得します。

構文

HRESULT GetLifeTime(
  [out] LIFE_TIME *pLifeTime
);

[out] pLifeTime

LIFE_TIME構造体へのポインター。

リターンコード	説明
S_OK	操作が成功しました。
E_OUTOFMEMORY	この操作を完了するのに十分なメモリがありません。
E_INVALIDARG	1 つ以上のパラメーターが正しく指定されていません。
E_NOTIMPL	この省略可能なメソッドは実装されていません。
E_ACCESSDENIED	呼び出し元には、診断または修復操作を実行するための十分な特権がありません。
E_ABORT	診断または修復操作が取り消されました。

ヘルパークラス拡張機能は、関数で発生したエラーに固有の HRESULTS を返す場合があります。

ヘルパークラス拡張機能をビルドする場合、このメソッドは必要ありません。

有効期間データは、問題のインスタンスの時間スコープを制限するために使用されます。これは、トレースやログ記録などの履歴ベースの診断を実行する場合に特に便利です。この診断を使用して、指定された時間間隔中に発生したイベントをスコープダウンできます。

たとえば、Windows フィルタープラットフォーム (WFP) ヘルパークラスは、有効期間を使用して、トレースログを確認してパケットをブロックしたフィルターを特定します。既定では、ヘルパークラスインスタンスの有効期間は、依存ヘルパークラスインスタンスの有効期間を継承します。