INapEnforcementClientBinding::NotifySoHChangeFailure method

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

See also

INapEnforcementClientBinding

INapEnforcementClientBinding::GetSoHRequest

INapEnforcementClientCallback::NotifySoHChange