Método INapSystemHealthAgentCallback::NotifyOrphanedSoHRequest

Observação

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

O método INapSystemHealthAgentCallback::NotifyOrphanedSoHRequest é chamado se um SoHRequest foi consultado do SHA, mas a resposta nunca mais voltou.

Sintaxe

HRESULT NotifyOrphanedSoHRequest(
  [in] const CorrelationId *correlationId
);

Parâmetros

correlationId [in]

Um ponteiro para a estrutura CorrelationId exclusiva que identifica o SoHRequest órfão.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Indica êxito.

Comentários

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

Esse método pode ser chamado pelo sistema nos seguintes casos:

• Um SoHRequest não pôde ser enviado na transmissão.
• Um SoHRequest foi enviado na transmissão, mas nenhum SoHResponse voltou, ou seja, o executor atingiu o tempo limite ou não havia nenhum SHV correspondente no lado do servidor.
• A conexão ficou inativa ou um executor ficou offline.

Essa é apenas uma notificação de melhor esforço, portanto, os SHAs não devem confiar nessas informações para limpo estado. Há várias situações em que um SHA não será notificado:

• Se um executor se comportar mal, ou seja, ele não notificará o SHA quando o estado da conexão estiver inativo.
• Se um executor falhar.
• Em condições de erro, ou seja, o NapAgent está sem memória.

Os SHAs podem receber algumas notificações falsas quando se associam pela primeira vez ao NapAgent, por exemplo, se uma troca de SoH estiver em andamento quando o SHA estiver associado e atingir o tempo limite.

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