SECURITY_MESSAGE struttura (rasshost.h)

Articolo
03/01/2024

La struttura SECURITY_MESSAGE viene usata con la funzione RasSecurityDialogComplete per indicare i risultati di una transazione di autenticazione DLL di sicurezza RAS.

Sintassi

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

Members

dwMsgId

Indica se il server RAS deve concedere l'accesso all'utente remoto. Questo membro può essere uno dei valori seguenti.

Valore	Significato
SECURITYMSG_SUCCESS	La DLL di sicurezza ha autenticato correttamente l'utente remoto identificato dal membro UserName . Il server RAS procede con l'autenticazione PPP.
SECURITYMSG_FAILURE	La DLL di sicurezza ha negato l'accesso all'utente remoto identificato dal membro UserName . Il server RAS blocca la chiamata e registra l'autenticazione non riuscita nel registro eventi.
SECURITYMSG_ERROR	Errore che ha impedito la convalida dell'utente remoto. Il server RAS blocca la chiamata e registra l'errore nel registro eventi.

hPort

Specifica l'handle di porta passato al server RAS alla DLL di sicurezza nella chiamata RasSecurityDialogBegin per questa transazione di autenticazione.

dwError

Specifica un codice di errore. Se dwMsgId è SECURITYMSG_ERROR, impostare dwError su uno dei codici di errore non zero definiti in Winerror.h o Raserror.h. Il server RAS registra questo codice di errore nel registro eventi. Se il membro dwMsgId indica l'esito positivo o l'errore, impostare dwError su zero.

UserName[UNLEN + 1]

Specifica il nome dell'utente remoto se dwMsgId è SECURITYMSG_SUCCESS o SECURITYMSG_FAILURE. Questa stringa può essere vuota se dwMsgId è SECURITYMSG_ERROR.

Domain[DNLEN + 1]

Specifica il nome del dominio di accesso per l'utente remoto se dwMsgId è SECURITYMSG_SUCCESS o SECURITYMSG_FAILURE. Questa stringa può essere vuota se dwMsgId è SECURITYMSG_ERROR.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	rasshost.h

Vedi anche

Strutture di amministrazione del server RAS

RasSecurityDialogBegin

RasSecurityDialogComplete

Panoramica del servizio di accesso remoto (RAS)

Share via