Método INapEnforcementClientConnection::SetCorrelationId

Observação

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

O método INapEnforcementClientConnection::SetCorrelationId define a ID usada para correlacionar SoH-requests e SoH-responses.

Sintaxe

HRESULT SetCorrelationId(
  [in] CorrelationId correlationId
);

Parâmetros

correlationId [in]

Uma estrutura CorrelationId exclusiva que identifica uma troca de SoH específica.

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

A id de correlação é definida pelo NapAgent e com base na id de conexão.

Essa ID é usada para correlacionar solicitações e respostas, ou seja, descreve exclusivamente uma troca de SoH e sempre contém a ID do conjunto de SoH mais recente no objeto de conexão.

Quando um SoH-Response é recebido, o NapAgent primeiro garante que as IDs correspondam; caso contrário, um erro será retornado e o executor deverá remover o pacote. Consulte INapEnforcementClientBinding::P rocessSoHResponse para obter mais detalhes.

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	NapEnforcementClient.h
IDL	NapEnforcementClient.idl
DLL	Qagent.dll

Confira também

INapEnforcementClientConnection