INapEnforcementClientBinding::NotifySoHChangeFailure method

Article
12/11/2020

Note

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

The INapEnforcementClientBinding::NotifySoHChangeFailure method is used by the enforcement client to inform the NapAgent that it could not process a previous INapEnforcementClientCallback::NotifySoHChange.

Syntax

HRESULT NotifySoHChangeFailure();

Parameters

This method has no parameters.

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

As a result of this method call the NapAgent retries applying the SoH change at a later time by calling INapEnforcementClientCallback::NotifySoHChange again. Once the enforcement client has called INapEnforcementClientBinding::GetSoHRequest, it then must apply the change, i.e. no failures are handled by the NapAgent after this point.

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

Share via