INapEnforcementClientBinding::ProcessSoHResponse method
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 |
|---|---|
|
The operation is successful. |
|
No connections have previously been created on the enforcement client. |
|
Permissions error, access denied. |
|
System resource limit, could not perform the operation. |
|
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). |
|
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. |
|
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 |
|
| IDL |
|
| DLL |
|