Método INapSystemHealthValidationRequest::GetSoHRequest

Observação

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

O método INapSystemHealthValidationRequest::GetSoHRequest permite que os SHVs (Validadores de Integridade do Sistema) recuperem e validem as informações de SoHRequest enviadas por seus equivalentes do SHA (System Health Agent) no cliente.

Sintaxe

HRESULT GetSoHRequest(
  [out] SoHRequest **sohRequest,
  [out] BOOL       *napSystemGenerated
);

Parâmetros

sohRequest [out]

Um ponteiro para um ponteiro para uma estrutura SoHRequest .

napSystemGenerated [out]

Um BOOL que será TRUE se o SoH tiver sido criado pelo NapAgent em nome do SHA e FALSE caso contrário. Ele é usado principalmente para indicar uma falha SHA no SHV.

Valor retornado

Outros códigos de erro específicos do COM também podem ser retornados.

Código de retorno	Descrição
S_OK	Êxito na operação.
E_ACCESSDENIED	Erro de permissões, acesso negado.
E_OUTOFMEMORY	O limite de recursos do sistema não pôde executar a operação.

Comentários

O parâmetro sohRequest poderá retornar NULL se o cliente não tiver enviado um SoHRequest para o SHV. Nesse cenário, o SHV pode preencher um SoHResponse com o código de erro de NAP_E_MISSING_SOH.

Se o parâmetro napSystemGenerated for TRUE, o formato soHRequest será o seguinte:

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	NapSystemHealthValidator.h
IDL	NapSystemHealthValidator.idl
DLL	Qshvhost.dll

Confira também

INapSystemHealthValidationRequest