MprAdminConnectionRemoveQuarantine function (mprapi.h)
The MprAdminConnectionRemoveQuarantine function removes quarantine filters on a dialed-in RAS client if the filters were applied as a result of Internet Authentication Service (IAS) policies.
Syntax
DWORD MprAdminConnectionRemoveQuarantine(
[in] HANDLE hRasServer,
[in] HANDLE hRasConnection,
[in] BOOL fIsIpAddress
);
Parameters
[in] hRasServer
Handle to the RAS server that services the connection. Obtain this handle by calling MprAdminServerConnect.
[in] hRasConnection
Handle to connection for the RAS client for which to remove the quarantine filters. Obtain this handle by calling MprAdminConnectionEnum.
Alternatively, this parameter specifies the IP address of the RAS client for which to remove the quarantine filter. The IP address should be specified as a DWORD in network byte order. Obtain the IP address by calling MprAdminConnectionEnum. If this parameter specifies an IP address, the fIsIpAddress parameter should specify a TRUE value.
[in] fIsIpAddress
Specifies a Boolean value that indicates whether the hRasConnection parameter specifies the IP address of the client for which to remove the quarantine filters. If this parameter is a TRUE value, hRasConnection specifies an IP address. Otherwise, hRasConnection specifies a handle to a connection.
Return value
If the function succeeds, the return value is NO_ERROR.
If the function fails, the return value is one of the following error codes.
| Return code | Description |
|---|---|
|
The handle to the RAS server or the handle to the RAS connection is invalid. |
|
The RAS client is not in quarantine. |
|
An error from MprError.h, RasError.h, or WinError.h. |
Remarks
If Internet Authentication Service (IAS) policies configure regular filters, then these filters are added to the RAS client interface as a result of calling MprAdminConnectionRemoveQuarantine.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | mprapi.h |
| Library | Mprapi.lib |
| DLL | Mprapi.dll |