다음을 통해 공유

INapSystemHealthAgentCallback::GetSoHRequest 메서드

  • 아티클

참고

네트워크 액세스 보호 플랫폼은 Windows 10

INapSystemHealthAgentCallback::GetSoHRequest 메서드는 시스템 상태 에이전트의 SoH 요청을 쿼리하기 위해 NapAgent에 의해 호출됩니다.

구문

HRESULT GetSoHRequest(
  [in] INapSystemHealthAgentRequest *request
);

매개 변수

request [in]

요청 개체를 식별하는 INapSystemHealthAgentRequest 개체에 대한 COM 포인터입니다.

반환 값

반환 코드 Description
S_OK
 성공을 나타냅니다.
HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)
 구현에서 이 코드를 반환하는 경우 NapAgent는 바인딩된 SHA 목록에서 SHA를 제거하고 캐시 항목을 플러시합니다.

구현에서 반환 값( HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE 제외)을 반환하면 NAP 시스템은 다음 특성 형식 및 값을 사용하여 해당 SHV에 SoHRequest 를 생성하고 반환합니다.

설명

이 콜백 메서드는 NAP 시스템에서 선언되며 SHA 작성기에 의해 구현됩니다.

이 메서드는 요청을 처리하고 즉시 반환해야 합니다. 이 메서드의 반환을 지연하면 시스템 성능 및 응답성에 부정적인 영향을 미치며 운영 체제의 다른 부분의 시간이 초과될 수 있습니다.

특히 계산 집약적이고 시간이 오래 걸리는 경우 이 호출의 일부로 상태 모니터링을 수행해서는 안 됩니다. 상태 모니터링 및 SoH 계산은 별도의 스레드 또는 서비스에서 수행해야 합니다. 이 메서드의 유일한 함수는 SHA의 SoH를 설정하고 반환하는 것입니다.

SHA가 SoH를 생성하는 데 시간이 오래 걸리는 경우 캐시된 SoH를 NapAgent로 반환해야 합니다. 반환할 캐시된 SoH가 없는 경우 SHA는 다음 특성 형식 및 값이 있는 SoH를 즉시 반환해야 합니다.

SoH가 생성되면 SHA는 INapSystemHealthAgentBinding::NotifySoHChange를 호출하여 시스템 상태 변경을 NapAgent에 알려야 합니다.

NapAgent는 이 메서드를 호출하여 시스템 상태 에이전트의 SoHRequest를 쿼리합니다. SHA는 전달된 INapSystemHealthAgentRequest 개체에서 SoHRequest를 계산하는 데 필요한 매개 변수를 쿼리할 수 있습니다. SHA는 요청 개체에서 계산된 SoHRequest를 설정해야 합니다. SHA는 이 호출이 완료되면 요청 개체에 대한 참조를 보유하지 않아야 합니다.

이 메서드가 호출되면 NapAgent의 캐시에 SoH가 있는 경우 요청 개체에 설정됩니다. SHA는 GetSoHRequest를 사용하여 쿼리할 수 있습니다. SHA가 새 SoH를 설정하지 않으면 캐시된 SoH가 사용됩니다.

시스템에 등록된 바인딩되지 않은 SHA의 경우 NAP 시스템은 다음과 같은 특성 형식 및 값을 사용하여 SoHRequest를 생성하고 해당 SHV에 보냅니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2008 [데스크톱 앱만 해당]
헤더
NapSystemHealthAgent.h
IDL
NapSystemHealthAgent.idl

추가 정보

INapSystemHealthAgentCallback