INapEnforcementClientBinding::ProcessSoHResponse method

Article
12/11/2020

Note

The Network Access Protection platform is not available starting with Windows 10

The INapEnforcementClientBinding::ProcessSoHResponse method is used by enforcement clients to process an SoHResponse whenever they receive an SoHResponse data blob from the enforcement server.

Syntax

HRESULT ProcessSoHResponse(
  [in] INapEnforcementClientConnection *connection
);

Parameters

connection [in]

A COM pointer to the INapEnforcementClientConnection interface of the client connection. The NapAgent does not hold references to the object associated with this interface after this method call completes.

You must use a previously established connection for processing SOHResponse data blobs.

Return value

Other COM-specific error codes also may be returned.

Return code	Description
S_OK	The operation is successful.
E_INVALIDARG	No connections have previously been created on the enforcement client.
E_ACCESSDENIED	Permissions error, access denied.
E_OUTOFMEMORY	System resource limit, could not perform the operation.
NAP_E_INVALID_PACKET	If this value is returned the enforcement client must drop the packet if the NapAgent returns NAP_E_INVALID_PACKET. In this case, the enforcer must assume that the server it is talking to is not NAP-enabled and remove the connection from the active list (i.e. notify the NapAgent of a connection state down).
NAP_E_MISMATCHED_ID	If this value is returned it indicates that the correlation id in the SoH-Response packet did not match the outstanding SoH-Response. In this case, the enforcer should drop the packet and wait for another newer SoH-Response packet. This may be caused by a response to an older request message.
NAP_E_NOT_INITIALIZED	The enforcer has not been previously initialized.

Remarks

The NapAgent queries the SoH-Response data blob from the connection object, processes it, and sets the resulting decision (eg. full/restricted access/etc) on the connection object.

The enforcement client must call the INapEnforcementClientBinding::Initialize method before calling this or any other method of the INapEnforcementClientBinding interface.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	NapEnforcementClient.h
IDL	NapEnforcementClient.idl
DLL	Qagent.dll