다음을 통해 공유


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

LowHealth 메서드를 사용하면 도우미 클래스 확장에서 진단되는 구성 요소가 정상인지 여부를 검사 수 있습니다.

구문

HRESULT LowHealth(
  [in]  LPCWSTR          pwszInstanceDescription,
  [out] LPWSTR           *ppwszDescription,
  [out] long             *pDeferredTime,
  [out] DIAGNOSIS_STATUS *pStatus
);

매개 변수

[in] pwszInstanceDescription

진단되는 정보에 대한 사용자에게 친숙한 설명을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 예를 들어 클래스가 IP 주소로 연결 문제를 진단하는 경우 pwszInstanceDescription 매개 변수에는 호스트 이름이 포함됩니다.

[out] ppwszDescription

구성 요소가 비정상인 경우 발견된 문제에 대한 설명을 포함하는 null로 종료된 문자열에 대한 포인터입니다.

[out] pDeferredTime

진단을 즉시 시작할 수 없는 경우 연기할 시간(초)에 대한 포인터입니다. pStatus 매개 변수가 DS_DEFERRED 설정된 경우에 사용됩니다.

[out] pStatus

진단에서 반환되는 DIAGNOSIS_STATUS 대한 포인터입니다.

반환 값

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

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

설명

LowHealth 메서드는 도우미 클래스 확장을 빌드할 때 필요합니다.

LowHealth가 DS_CONFIRMED 반환하는 경우 ppwszDescription 에는 진단 결과에 대한 사용자 친화적인 설명도 포함됩니다. out 매개 변수 pDeferredTime 에는 pStatus가 DS_DEFERRED 반환하는 경우 이 진단을 연기해야 하는 시간(초)이 포함됩니다.

LowHealth가 확인되면 다른 구성 요소로 인해 문제가 발생할 수 있는 경우 다른 도우미 클래스에 대한 GetLowerHypotheses 메서드에서 가설을 선택적으로 생성할 수도 있습니다. 확인되지 않은 경우 NDF는 HighUtilization을 호출하여 문제를 추가로 진단할 수 있습니다.

LowHealth는 문제를 진단할 수 없지만 구성 요소가 정상인지 확인할 수 없는 경우 DS_INDETERMINATE 반환할 수도 있습니다. 이 경우 NDF는 다른 가설이 확인되지 않으면 DS_CONFIRMED 처리합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 ndhelper.h

추가 정보

INetDiagHelper