Fonction RasSecurityDialogSend (rasshost.h)

Article
03/01/2024

La fonction RasSecurityDialogSend envoie un message à afficher dans une fenêtre de terminal sur un ordinateur distant. Une DLL de sécurité RAS tierce envoie ce message dans le cadre de son authentification d’un utilisateur distant.

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 RasSecurityDialogSend 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 ISDN (Integrated Services Digital Network) ou VPN (Virtual Private Network), ne sont pas prises en charge.

Syntaxe

DWORD RasSecurityDialogSend(
  [in] HPORT hPort,
  [in] PBYTE pBuffer,
  [in] WORD  BufferLength
);

Paramètres

[in] hPort

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

[in] pBuffer

Pointeur vers la mémoire tampon d’envoi qui a été passée à la DLL de sécurité dans l’appel à RasSecurityDialogBegin. Avant d’appeler RasSecurityDialogSend, copiez dans cette mémoire tampon le message à envoyer à l’utilisateur distant. Le paramètre SendBufSize de la fonction RasSecurityDialogBegin indique le nombre maximal d’octets que la mémoire tampon peut stocker.

[in] BufferLength

Spécifie le nombre d’octets à envoyer dans la mémoire tampon pBuffer .

Valeur retournée

Si la fonction réussit, la valeur de retour est PENDING (définie dans Raserror.h). Cela indique que l’opération d’envoi est en cours.

Si une erreur se produit, 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 étendues sur les erreurs.

Remarques

La fonction RasSecurityDialogSend est asynchrone. Après l’avoir appelé pour envoyer un message à l’utilisateur distant, appelez la fonction RasSecurityDialogReceive , puis attendez une réponse. La DLL de sécurité peut effectuer n’importe quel nombre d’appels RasSecurityDialogSend , chaque appel suivi d’un appel RasSecurityDialogReceive .

Lorsqu’une DLL de sécurité authentifie un utilisateur distant, l’opération de connexion sur l’ordinateur distant entre dans un état RASCS_Interactive suspendu. Le message envoyé par RasSecurityDialogSend s’affiche en sortie dans une fenêtre de terminal sur l’ordinateur distant. La réponse reçue par RasSecurityDialogReceive est l’entrée que l’utilisateur distant tape dans la fenêtre du terminal. La valeur RASCS_Interactive est définie dans l’énumération RASCONNSTATE .

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