RasSecurityDialogBegin, fonction (rasshost.h)
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.
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
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 |