INapEnforcementClientCallback::NotifySoHChange method
Note
The Network Access Protection platform is not available starting with Windows 10
The INapEnforcementClientCallback::NotifySoHChange callback method is used by the NapAgent to inform the enforcement client of SoH changes.
Syntax
HRESULT NotifySoHChange();
Parameters
This method has no parameters.
Return value
This callback method must return one the following error codes.
| Return code | Description |
|---|---|
|
Return this value if the operation succeeded. |
|
Returning this value causes the enforcer to be removed from the bound-SHA list, and the corresponding NapAgent cache entry to be flushed. The failing SHA can then re-initialize itself with the NapAgent. |
Remarks
The completion of system fix-up is a system health change event. That means you must call NotifySoHChange when a INapSystemHealthAgentCallback::GetFixupInfo notification indicates that the client is fixed. When a client is fixed, the state member of the FixupInfo structure returned by GetFixupInfo has a value of fixupStateSuccess.
After being called by the NapAgent via this callback, the enforcement agent must then call INapEnforcementClientBinding::GetSoHRequest to retrieve the new request. This call can be made on the same thread as INapEnforcementClientCallback::NotifySoHChange.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2008 [desktop apps only] |
| Header |
|
| IDL |
|
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for