Metodo INapSystemHealthAgentCallback::GetSoHRequest

Articolo
06/13/2023

Nota

La piattaforma Protezione accesso alla rete non è disponibile a partire da Windows 10

Il metodo INapSystemHealthAgentCallback::GetSoHRequest viene chiamato da NapAgent per eseguire una query sulla richiesta SoH dell'agente integrità di sistema.

Sintassi

HRESULT GetSoHRequest(
  [in] INapSystemHealthAgentRequest *request
);

Parametri

richiesta [in]: Puntatore COM a un oggetto INapSystemHealthAgentRequest che identifica l'oggetto richiesta.

Valore restituito

Codice restituito	Descrizione
S_OK	Indica l'esito positivo dell'operazione.
HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)	Se questo codice viene restituito dall'implementazione, NapAgent rimuove sha dall'elenco sha associato e scarica la voce della cache.

Quando qualsiasi valore restituito (ad eccezione di HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)) viene restituito dall'implementazione, il sistema NAP costruisce e restituisce un oggetto SoHRequest all'SHV corrispondente con i tipi e i valori di attributo seguenti:

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

Commenti

Questo metodo di callback viene dichiarato dal sistema protezione accesso alla rete e deve essere implementato dal writer SHA.

Questo metodo deve elaborare la richiesta e restituire immediatamente. Il ritardo della restituzione di questo metodo influisce negativamente sulle prestazioni e sulla velocità di risposta del sistema e può causare il timeout di altre parti del sistema operativo.

Il monitoraggio dello stato di integrità non deve essere eseguito come parte di questa chiamata, soprattutto se è a elevato utilizzo di calcolo e richiede molto tempo. Il monitoraggio dello stato di integrità e il calcolo SoH devono essere eseguiti in un thread o un servizio separato. L'unica funzione di questo metodo deve essere quella di impostare l'oggetto SoH sha e restituire.

Se la generazione di un SoH da parte di SHA richiede molto tempo, l'oggetto SoH memorizzato nella cache deve essere restituito a NapAgent. Se non è presente alcun oggetto SoH memorizzato nella cache, l'sha deve restituire immediatamente un oggetto SoH con i tipi e i valori di attributo seguenti:

Quando l'oggetto SoH è stato generato, sha deve chiamare INapSystemHealthAgentBinding::NotifySoHChange per notificare a NapAgent la modifica dell'integrità del sistema.

NapAgent chiama questo metodo per eseguire una query sull'agente di integrità del sistema SoHRequest. SHA può eseguire una query sull'oggetto INapSystemHealthAgentRequest passato per i parametri necessari per calcolare l'oggetto SoHRequest. Sha deve impostare l'oggetto SoHRequest calcolato nell'oggetto richiesta. L'sha non deve contenere riferimenti all'oggetto richiesta al termine della chiamata.

Quando questo metodo viene chiamato, se nella cache di NapAgent è presente un oggetto SoH, viene impostato sull'oggetto richiesta. Sha può eseguire una query usando GetSoHRequest. Se sha non imposta un nuovo soH, viene usato quello memorizzato nella cache.

Per gli SHA non associati registrati nel sistema, il sistema NAP costruisce e invia un Oggetto SoHRequest al SHV corrispondente con i tipi e i valori di attributo seguenti:

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	NapSystemHealthAgent.h
IDL	NapSystemHealthAgent.idl

Vedi anche

INapSystemHealthAgentCallback

Condividi tramite