INapEnforcementClientBinding::GetSoHRequest method

Note

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

The INapEnforcementClientBinding::GetSoHRequest method is used by the enforcement client to retrieve an SoH-request for a particular connection.

Syntax

HRESULT GetSoHRequest(
  [in]  INapEnforcementClientConnection *connection,
  [out] BOOL                            *retriggerHint
);

connection [in]: A COM pointer to an INapEnforcementClientConnection interface. The NapAgent does not hold references to the object associated with this interface after the method completes.
retriggerHint [out]: A pointer to a BOOL that indicates if the connection should be re-triggered. It is TRUE if the SoHRequest has changed since this function was last called or if ProbationTime has expired. Otherwise, FALSE is returned.

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.

The NapAgent sets the SoHRequest on the connection object.

If an SoHRequest was outstanding on this connection, then it is discarded, and the SHAs are notified of orphaned SoHRequests.

The enforcement client must call the INapEnforcementClientBinding::Initialize method before calling this or any other method of the INapEnforcementClientBinding interface.

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