Метод INapSystemHealthAgentCallback::GetSoHRequest

Метод INapSystemHealthAgentCallback::GetSoHRequest вызывается NapAgent для запроса soH агента работоспособности системы.

Синтаксис

HRESULT GetSoHRequest(
  [in] INapSystemHealthAgentRequest *request
);

Параметры

request [in]

COM-указатель на объект INapSystemHealthAgentRequest , идентифицирующий объект запроса.

Возвращаемое значение

Если реализация возвращает любое возвращаемое значение (кроме HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)), система NAP создает и возвращает SoHRequest соответствующему shV со следующими типами атрибутов и значениями:

• sohAttributeTypeSystemHealthId= <id>
• sohAttributeTypeFailureCategory= failureCategoryClientComponent
• sohAttributeTypeErrorCodes = <error-code>

Комментарии

Этот метод обратного вызова объявляется системой NAP и реализуется модулем записи SHA.

Этот метод должен обрабатывать запрос и немедленно возвращать его. Задержка возврата этого метода негативно влияет на производительность и скорость отклика системы и может привести к истечению времени ожидания других частей операционной системы.

Мониторинг состояния работоспособности не следует выполнять в рамках этого вызова, особенно если он является ресурсоемким и занимает много времени. Мониторинг состояния работоспособности и вычисление SoH должны выполняться в отдельном потоке или службе. Единственной функцией этого метода должно быть установка soH SHA и возврат.

Если для создания SoH sha потребуется много времени, кэшированный soH следует вернуть в NapAgent. Если кэшированный SoH не возвращается, SHA должен немедленно вернуть SoH со следующими типами и значениями атрибутов:

• sohAttributeTypeSystemHealthId= <id>
• sohAttributeTypeFailureCategory= failureCategoryClientCommunication
• sohAttributeTypeErrorCodes = NAP_E_NO_CACHED_SOH

После создания SoH SHA должен вызвать INapSystemHealthAgentBinding::NotifySoHChange , чтобы уведомить NapAgent об изменении работоспособности системы.

NapAgent вызывает этот метод для запроса SoHRequest агента работоспособности системы. SHA может запрашивать у переданного объекта INapSystemHealthAgentRequest параметры, необходимые для вычисления SoHRequest. Sha должен задать вычисляемый объект SoHRequest для объекта запроса. Sha не должен содержать ссылки на объект запроса после завершения этого вызова.

При вызове этого метода, если в кэше NapAgent есть SoH, он задается в объекте запроса. Sha может запрашивать его с помощью GetSoHRequest. Если SHA не задает новый SoH, используется кэшированный.

Для несвязанных shas, зарегистрированных в системе, система NAP создает и отправляет SoHRequest в соответствующее SHV со следующими типами атрибутов и значениями:

• sohAttributeTypeSystemHealthId= <id>
• sohAttributeTypeFailureCategory= failureCategoryClientComponent
• sohAttributeTypeErrorCodes = NAP_E_NOT_INITIALIZED

Требования

См. также раздел

INapSystemHealthAgentCallback