Fonction RasSecurityDialogGetInfo (rasshost.h)

Article
03/09/2024

La fonction RasSecurityDialogGetInfo est appelée par une DLL de sécurité RAS pour obtenir des informations sur un port à partir du serveur RAS.

Pour appeler cette fonction, appelez d’abord la fonction LoadLibrary pour charger Rasman.dll. Appelez ensuite la fonction GetProcAddress pour obtenir le point d’entrée RasSecurityDialogGetInfo de la DLL.

Note Windows Server 2008, Windows Server 2003, Windows 2000 Server et Windows NT Server 4.0 fournissent actuellement une prise en charge de l’hôte de sécurité RAS pour les appareils série uniquement. D’autres types de connexions, tels que les connexions de réseau numérique de services intégrés (ISDN) ou de réseau privé virtuel (VPN), ne sont pas pris en charge.

Syntaxe

DWORD RasSecurityDialogGetInfo(
  [in] HPORT             hPort,
  [in] RAS_SECURITY_INFO *pBuffer
);

Paramètres

[in] hPort

Spécifie le handle de port que le serveur RAS a transmis à la DLL de sécurité dans l’appel RasSecurityDialogBegin pour cette transaction d’authentification.

[in] pBuffer

Pointeur vers la structure RAS_SECURITY_INFO qui reçoit des informations sur le port RAS spécifié.

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 définis dans Raserror.h ou Winerror.h. GetLastError ne fournit pas d’informations d’erreur étendues.

Remarques

La fonction RasSecurityDialogGetInfo récupère des informations sur le port associé à une transaction d’authentification DE DLL de sécurité RAS.

Le membre LastError de la structure RAS_SECURITY_INFO indique l’état du dernier appel RasSecurityDialogReceive pour le port. Si l’opération de réception a été effectuée avec succès, LastError a la valeur SUCCESS et le membre BytesReceived indique le nombre d’octets reçus. Sinon, LastError est EN ATTENTE si l’opération de réception est toujours en cours, ou un code d’erreur différent de zéro si l’opération de réception a échoué.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	rasshost.h
DLL	Rasman.dll