MprAdminConnectionRemoveQuarantine-Funktion (mprapi.h)

Artikel
02/29/2024

Die Funktion MprAdminConnectionRemoveQuarantine entfernt Quarantänefilter auf einem eingewählten RAS-Client, wenn die Filter als Ergebnis von IAS-Richtlinien (Internet Authentication Service) angewendet wurden.

Syntax

DWORD MprAdminConnectionRemoveQuarantine(
  [in] HANDLE hRasServer,
  [in] HANDLE hRasConnection,
  [in] BOOL   fIsIpAddress
);

Parameter

[in] hRasServer

Handle an den RAS-Server, der die Verbindung verarbeitet. Rufen Sie dieses Handle ab, indem Sie MprAdminServerConnect aufrufen.

[in] hRasConnection

Handle to connection for the RAS client for which to remove the quarantäne filter. Rufen Sie dieses Handle ab, indem Sie MprAdminConnectionEnum aufrufen.

Alternativ gibt dieser Parameter die IP-Adresse des RAS-Clients an, für den der Quarantänefilter entfernt werden soll. Die IP-Adresse sollte als DWORD in der Netzwerkbytereihenfolge angegeben werden. Rufen Sie die IP-Adresse ab, indem Sie MprAdminConnectionEnum aufrufen. Wenn dieser Parameter eine IP-Adresse angibt, sollte der fIsIpAddress-Parameter einen TRUE-Wert angeben.

[in] fIsIpAddress

Gibt einen booleschen Wert an, der angibt, ob der hRasConnection-Parameter die IP-Adresse des Clients angibt, für den die Quarantänefilter entfernt werden sollen. Wenn dieser Parameter ein TRUE-Wert ist, gibt hRasConnection eine IP-Adresse an. Andernfalls gibt hRasConnection ein Handle für eine Verbindung an.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Das Handle für den RAS-Server oder das Handle für die RAS-Verbindung ist ungültig.
ERROR_NOT_FOUND	Der RAS-Client befindet sich nicht in Quarantäne.
Andere	Ein Fehler von "MprError.h", "RasError.h" oder "WinError.h".

Hinweise

Wenn IAS-Richtlinien (Internet Authentication Service) reguläre Filter konfigurieren, werden diese Filter der RAS-Clientschnittstelle als Ergebnis des Aufrufs von MprAdminConnectionRemoveQuarantine hinzugefügt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h
Bibliothek	Mprapi.lib
DLL	Mprapi.dll

Weitere Informationen

MprAdminConnectionEnum

MprAdminServerConnect

RAS-Verwaltungsfunktionen

Remotezugriffsdienst-Verwaltungsreferenz

Share via