INetDiagHelper::GetLifeTime メソッド (ndhelper.h)
GetLifeTime メソッドは、ヘルパー クラス拡張インスタンスの有効期間を取得します。
構文
HRESULT GetLifeTime(
[out] LIFE_TIME *pLifeTime
);
パラメーター
[out] pLifeTime
LIFE_TIME構造体へのポインター。
戻り値
| リターン コード | 説明 |
|---|---|
|
操作が成功しました。 |
|
この操作を完了するのに十分なメモリがありません。 |
|
1 つ以上のパラメーターが正しく指定されていません。 |
|
この省略可能なメソッドは実装されていません。 |
|
呼び出し元には、診断または修復操作を実行するための十分な特権がありません。 |
|
診断または修復操作が取り消されました。 |
ヘルパー クラス拡張機能は、関数で発生したエラーに固有の HRESULTS を返す場合があります。
注釈
ヘルパー クラス拡張機能をビルドする場合、このメソッドは必要ありません。
有効期間データは、問題のインスタンスの時間スコープを制限するために使用されます。 これは、トレースやログ記録などの履歴ベースの診断を実行する場合に特に便利です。この診断を使用して、指定された時間間隔中に発生したイベントをスコープダウンできます。
たとえば、Windows フィルター プラットフォーム (WFP) ヘルパー クラスは、有効期間を使用して、トレース ログを確認してパケットをブロックしたフィルターを特定します。 既定では、ヘルパー クラス インスタンスの有効期間は、依存ヘルパー クラス インスタンスの有効期間を継承します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ndhelper.h |