INapEnforcementClientBinding::NotifyConnectionStateDown method

Note

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

The INapEnforcementClientBinding::NotifyConnectionStateDown method is used to inform the NapAgent that a connection to an enforcement client has gone down.

Syntax

HRESULT NotifyConnectionStateDown(
  [in] INapEnforcementClientConnection *downCxn
);

Parameters

downCxn [in]

A COM pointer to the INapEnforcementClientConnection interface of the down connection.

Return value

Other COM-specific error codes also may be returned.

Return code Description
S_OK
The operation is successful.
E_ACCESSDENIED
Permissions error, access denied.
E_OUTOFMEMORY
System resource limit, could not perform the operation.
NAP_E_NOT_INITIALIZED
The enforcer has not been previously initialized.

Remarks

When any of the connections established by an enforcement client go down, the enforcement client should remove the connection from its active list and inform the NapAgent using this method. As soon as this call returns, the connection object can be released and freed. The NapAgent will not hold references to the connection object.

As a result of this notification, the NapAgent updates its system NAP state as appropriate.

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

See also

INapEnforcementClientBinding