RasSecurityDialogBegin, fonction (rasshost.h)

  • Article

La fonction RasSecurityDialogBegin est un point d’entrée DE DLL de sécurité RAS tiers que le serveur RAS appelle lorsqu’un utilisateur distant tente de se connecter. Cela permet à la DLL de sécurité de commencer son authentification de l’utilisateur distant.

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 RasSecurityDialogBegin(
  [in] HPORT                        hPort,
  [in] PBYTE                        pSendBuf,
  [in] DWORD                        SendBufSize,
  [in] PBYTE                        pRecvBuf,
  [in] DWORD                        RecvBufSize,
       VOID(* )(SECURITY_MESSAGE *) RasSecurityDialogComplete
);

Paramètres

[in] hPort

Spécifie un handle de port RAS. La DLL de sécurité utilise ce handle dans d’autres fonctions de sécurité RAS, telles que RasSecurityDialogSend et RasSecurityDialogReceive, pour identifier cette transaction d’authentification.

Notez que ce handle est valide uniquement dans les fonctions de sécurité RAS ; ne l’utilisez pas dans d’autres fonctions d’E/S.

[in] pSendBuf

Pointeur vers une mémoire tampon allouée par le serveur RAS. La DLL de sécurité utilise cette mémoire tampon avec la fonction RasSecurityDialogSend pour envoyer du texte affiché dans la fenêtre du terminal RAS sur l’ordinateur distant.

[in] SendBufSize

Spécifie la taille, en octets, de la mémoire tampon pSendBuf .

[in] pRecvBuf

Pointeur vers une mémoire tampon allouée par le serveur RAS. La DLL de sécurité utilise cette mémoire tampon avec la fonction RasSecurityDialogReceive pour recevoir la réponse de l’utilisateur distant.

[in] RecvBufSize

Spécifie la taille, en octets, de la mémoire tampon pRecvBuf .

RasSecurityDialogComplete

Valeur retournée

Si la DLL de sécurité démarre correctement l’opération d’authentification, RasSecurityDialogBegin doit retourner NO_ERROR. Dans ce cas, la DLL de sécurité doit arrêter ultérieurement la transaction d’authentification en appelant la fonction pointée par le paramètre RasSecurityDialogComplete .

Si une erreur se produit, RasSecurityDialogBegin doit retourner un code d’erreur différent de zéro. Dans ce cas, le serveur RAS raccroche l’appel et enregistre l’erreur dans le journal des événements. Le renvoi d’un code d’erreur différent de zéro met fin à la transaction d’authentification, de sorte que la DLL de sécurité n’a pas besoin d’appeler la fonction RasSecurityDialogComplete .

Remarques

Lorsqu’un serveur RAS reçoit un appel d’un ordinateur distant, il appelle la fonction RasSecurityDialogBegin exportée par la DLL de sécurité RAS inscrite, le cas échéant. Lorsque le serveur RAS appelle cette fonction, il transmet les informations suivantes à la DLL de sécurité :

  • Un handle de port pour identifier la connexion
  • Pointeurs vers les mémoires tampons à utiliser lors de la communication avec l’utilisateur distant
  • Pointeur vers la fonction RasSecurityDialogComplete à appeler une fois l’authentification terminée
Le handle de port et les pointeurs de mémoire tampon sont valides jusqu’à ce que RasSecurityDialogComplete soit appelé pour arrêter la transaction d’authentification.

L’implémentation RasSecurityDialogBegin doit retourner dès que possible, car le serveur RAS est bloqué et ne peut accepter aucun autre appel tant que RasSecurityDialogBegin n’est pas retourné. La fonction RasSecurityDialogBegin doit copier les paramètres d’entrée et créer un thread pour communiquer avec l’utilisateur distant et l’authentifier.

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

Voir aussi

Fonctions d’administration du serveur RAS

RasSecurityDialogComplete

RasSecurityDialogReceive

RasSecurityDialogSend

Vue d’ensemble du service d’accès à distance (RAS)