INetDiagHelper::GetLifeTime 메서드(ndhelper.h)

GetLifeTime 메서드는 도우미 클래스 확장 instance 수명을 검색합니다.

구문

HRESULT GetLifeTime(
  [out] LIFE_TIME *pLifeTime
);

[out] pLifeTime

LIFE_TIME 구조체에 대한 포인터입니다.

반환 코드	Description
S_OK	작업에 성공했습니다.
E_OUTOFMEMORY	이 작업을 완료하는 데 사용할 수 있는 메모리가 부족합니다.
E_INVALIDARG	하나 이상의 매개 변수가 올바르게 제공되지 않았습니다.
E_NOTIMPL	이 선택적 메서드는 구현되지 않습니다.
E_ACCESSDENIED	호출자에게 진단 또는 복구 작업을 수행할 수 있는 충분한 권한이 없습니다.
E_ABORT	진단 또는 복구 작업이 취소되었습니다.

도우미 클래스 확장은 함수에서 발생한 오류와 관련된 HRESULTS를 반환할 수 있습니다.

도우미 클래스 확장을 빌드할 때는 이 메서드가 필요하지 않습니다.

수명 데이터는 문제 instance scope 시간을 제한하는 데 사용됩니다. 이는 지정된 시간 간격 동안 발생한 이벤트에 대한 진단 범위를 지정하는 데 사용할 수 있는 추적 및 로깅과 같은 기록 기반 진단을 수행할 때 특히 유용합니다.

예를 들어 WFP(Windows Filtering Platform) 도우미 클래스는 수명을 사용하여 추적 로그를 확인하여 패킷을 차단한 필터를 결정합니다. 기본적으로 도우미 클래스 instance 수명은 종속 도우미 클래스 instance 수명을 상속합니다.