Método INapSystemHealthAgentCallback::GetSoHRequest

NapAgent llama al método INapSystemHealthAgentCallback::GetSoHRequest para consultar la solicitud soH del agente de mantenimiento del sistema.

Sintaxis

HRESULT GetSoHRequest(
  [in] INapSystemHealthAgentRequest *request
);

Parámetros

request [in]

Puntero COM a un objeto INapSystemHealthAgentRequest que identifica el objeto de solicitud.

Valor devuelto

Cuando la implementación devuelve cualquier valor devuelto (excepto HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)), el sistema NAP crea y devuelve un SoHRequest al SHV correspondiente con los siguientes tipos de atributo y valores:

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

Observaciones

El sistema NAP declara este método de devolución de llamada y el escritor SHA lo implementará.

Este método debe procesar la solicitud y devolverla inmediatamente. Retrasar el retorno de este método afecta negativamente al rendimiento y la capacidad de respuesta del sistema, y puede provocar que otras partes del sistema operativo agoten el tiempo de espera.

La supervisión del estado de mantenimiento no debe realizarse como parte de esta llamada, especialmente si se realiza un cálculo intensivo y tarda mucho tiempo. La supervisión del estado de mantenimiento y el cálculo de SoH deben realizarse en un subproceso o servicio independiente. La única función de este método debe ser establecer el SoH de SHA y devolver.

Si el SHA tardará mucho tiempo en generar un SoH, el SoH almacenado en caché debe devolverse a NapAgent. Si no hay ningún SoH almacenado en caché para devolver, el SHA debe devolver inmediatamente un SoH con los siguientes tipos de atributo y valores:

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

Cuando se ha generado el SoH, el SHA debe llamar a INapSystemHealthAgentBinding::NotifySoHChange para notificar al NapAgent del cambio de estado del sistema.

NapAgent llama a este método para consultar el SoHRequest del agente de mantenimiento del sistema. Sha puede consultar el objeto INapSystemHealthAgentRequest pasado para ver los parámetros que necesita para calcular soHRequest. El SHA debe establecer el SoHRequest calculado en el objeto de solicitud. El SHA no debe contener referencias al objeto de solicitud una vez completada esta llamada.

Cuando se llama a este método, si hay un SoH en la memoria caché de NapAgent, se establece en el objeto de solicitud. Sha puede consultarlo mediante GetSoHRequest. Si sha no establece un soH nuevo, se usa el almacenado en caché.

En el caso de los SHAs no enlazados registrados con el sistema, el sistema NAP crea y envía un SoHRequest al SHV correspondiente con los siguientes tipos de atributos y valores:

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

Requisitos

Vea también

INapSystemHealthAgentCallback