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 |
---|---|
|
작업에 성공했습니다. |
|
이 작업을 완료하는 데 사용할 수 있는 메모리가 부족합니다. |
|
하나 이상의 매개 변수가 올바르게 제공되지 않았습니다. |
|
호출자에게 진단 또는 복구 작업을 수행할 수 있는 충분한 권한이 없습니다. |
|
진단 또는 복구 작업이 취소되었습니다. |
도우미 클래스 확장은 함수에서 발생한 오류와 관련된 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 |