SECURITY_MESSAGE structure (rasshost.h)

Article
03/04/2024

La structure SECURITY_MESSAGE est utilisée avec la fonction RasSecurityDialogComplete pour indiquer les résultats d’une transaction d’authentification DE DLL de sécurité RAS.

Syntaxe

typedef struct _SECURITY_MESSAGE {
  DWORD dwMsgId;
  HPORT hPort;
  DWORD dwError;
  CHAR  UserName[UNLEN + 1];
  CHAR  Domain[DNLEN + 1];
} SECURITY_MESSAGE, *PSECURITY_MESSAGE;

Membres

dwMsgId

Indique si le serveur RAS doit accorder l’accès à l’utilisateur distant. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
SECURITYMSG_SUCCESS	La DLL de sécurité a correctement authentifié l’utilisateur distant identifié par le membre UserName . Le serveur RAS procède à son authentification PPP.
SECURITYMSG_FAILURE	La DLL de sécurité a refusé l’accès à l’utilisateur distant identifié par le membre UserName . Le serveur RAS raccroche l’appel et enregistre l’échec de l’authentification dans le journal des événements.
SECURITYMSG_ERROR	Une erreur s’est produite qui a empêché la validation de l’utilisateur distant. Le serveur RAS raccroche l’appel et enregistre l’erreur dans le journal des événements.

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.

dwError

Spécifie un code d’erreur. Si dwMsgId est SECURITYMSG_ERROR, définissez dwError sur l’un des codes d’erreur différent de zéro défini dans Winerror.h ou Raserror.h. Le serveur RAS enregistre ce code d’erreur dans le journal des événements. Si le membre dwMsgId indique la réussite ou l’échec, définissez dwError sur zéro.

UserName[UNLEN + 1]

Spécifie le nom de l’utilisateur distant si dwMsgId est SECURITYMSG_SUCCESS ou SECURITYMSG_FAILURE. Cette chaîne peut être vide si dwMsgId est SECURITYMSG_ERROR.

Domain[DNLEN + 1]

Spécifie le nom du domaine d’ouverture de session de l’utilisateur distant si dwMsgId est SECURITYMSG_SUCCESS ou SECURITYMSG_FAILURE. Cette chaîne peut être vide si dwMsgId est SECURITYMSG_ERROR.

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]
En-tête	rasshost.h

Voir aussi

Structures d’administration du serveur RAS

RasSecurityDialogBegin

RasSecurityDialogComplete

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

Partager via