MprAdminConnectionRemoveQuarantine, fonction (mprapi.h)

Article
02/29/2024

La fonction MprAdminConnectionRemoveQuarantine supprime les filtres de quarantaine sur un client RAS avec numérotation si les filtres ont été appliqués à la suite de stratégies du service d’authentification Internet (IAS).

Syntaxe

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

Paramètres

[in] hRasServer

Gérez le serveur RAS qui gère la connexion. Obtenez ce handle en appelant MprAdminServerConnect.

[in] hRasConnection

Gérez la connexion pour le client RAS pour lequel supprimer les filtres de quarantaine. Obtenez ce handle en appelant MprAdminConnectionEnum.

Ce paramètre spécifie également l’adresse IP du client RAS pour lequel supprimer le filtre de quarantaine. L’adresse IP doit être spécifiée en tant que DWORD dans l’ordre d’octets réseau. Obtenez l’adresse IP en appelant MprAdminConnectionEnum. Si ce paramètre spécifie une adresse IP, le paramètre fIsIpAddress doit spécifier une valeur TRUE .

[in] fIsIpAddress

Spécifie une valeur booléenne qui indique si le paramètre hRasConnection spécifie l’adresse IP du client pour lequel supprimer les filtres de quarantaine. Si ce paramètre est une valeur TRUE , hRasConnection spécifie une adresse IP. Sinon, hRasConnection spécifie un handle pour une connexion.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_INVALID_PARAMETER	Le handle du serveur RAS ou du handle de la connexion RAS n’est pas valide.
ERROR_NOT_FOUND	Le client RAS n’est pas en quarantaine.
Autres	Erreur de MprError.h, RasError.h ou WinError.h.

Remarques

Si les stratégies IAS (Internet Authentication Service) configurent des filtres réguliers, ces filtres sont ajoutés à l’interface cliente RAS à la suite de l’appel de MprAdminConnectionRemoveQuarantine.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mprapi.h
Bibliothèque	Mprapi.lib
DLL	Mprapi.dll

Voir aussi

MprAdminConnectionEnum

MprAdminServerConnect

Fonctions d’administration RAS

Informations de référence sur l’administration du service d’accès à distance