Método INapSystemHealthAgentCallback::GetSoHRequest

Observação

A plataforma de Proteção de Acesso à Rede não está disponível a partir do Windows 10

O método INapSystemHealthAgentCallback::GetSoHRequest é chamado pelo NapAgent para consultar a solicitação SoH do agente de integridade do sistema.

Sintaxe

HRESULT GetSoHRequest(
  [in] INapSystemHealthAgentRequest *request
);

Parâmetros

solicitação [in]

Um ponteiro COM para um objeto INapSystemHealthAgentRequest que identifica o objeto de solicitação.

Valor retornado

Código de retorno	Descrição
S_OK	Indica êxito.
HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)	Se esse código for retornado pela implementação, o NapAgent removerá o SHA da lista bound-SHA e liberará sua entrada de cache.

Quando qualquer valor retornado (exceto HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)) é retornado pela implementação, o sistema NAP constrói e retorna um SoHRequest para o SHV correspondente com os seguintes tipos de atributo e valores:

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

Comentários

Esse método de retorno de chamada é declarado pelo sistema NAP e deve ser implementado pelo gravador SHA.

Esse método deve processar a solicitação e retornar imediatamente. Atrasar o retorno desse método afeta negativamente o desempenho e a capacidade de resposta do sistema e pode causar o tempo limite de outras partes do sistema operacional.

O monitoramento do estado de integridade não deve ser feito como parte dessa chamada, especialmente se for intensivo em computação e levar muito tempo. O monitoramento de estado de integridade e a computação SoH devem ser executados em um thread ou serviço separado. A única função desse método deve ser definir o SoH do SHA e retornar.

Se levar muito tempo para o SHA gerar um SoH, o SoH armazenado em cache deverá ser retornado ao NapAgent. Se não houver nenhum SoH armazenado em cache para retornar, o SHA deverá retornar imediatamente um SoH com os seguintes tipos de atributo e valores:

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

Quando o SoH tiver sido gerado, o SHA deverá chamar INapSystemHealthAgentBinding::NotifySoHChange para notificar o NapAgent sobre a alteração de integridade do sistema.

O NapAgent chama esse método para consultar o SoHRequest do agente de integridade do sistema. O SHA pode consultar o objeto INapSystemHealthAgentRequest passado para obter parâmetros necessários para calcular o SoHRequest. O SHA deve definir o SoHRequest computado no objeto de solicitação. O SHA não deve conter referências ao objeto de solicitação depois que essa chamada for concluída.

Quando esse método é chamado, se houver um SoH no cache do NapAgent, ele será definido no objeto de solicitação. O SHA pode consultá-lo usando GetSoHRequest. Se o SHA não definir um novo SoH, o armazenado em cache será usado.

Para SHAs não associados que são registrados com o sistema, o sistema NAP constrói e envia um SoHRequest para o SHV correspondente com os seguintes tipos de atributo e valores:

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	NapSystemHealthAgent.h
IDL	NapSystemHealthAgent.idl

Confira também

INapSystemHealthAgentCallback