Freigeben über

SECURITY_MESSAGE-Struktur (rasshost.h)

  • Artikel

Die SECURITY_MESSAGE-Struktur wird zusammen mit der RasSecurityDialogComplete-Funktion verwendet, um die Ergebnisse einer RAS-Sicherheits-DLL-Authentifizierungstransaktion anzugeben.

Syntax

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

Member

dwMsgId

Gibt an, ob der RAS-Server dem Remotebenutzer Zugriff gewähren soll. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
SECURITYMSG_SUCCESS
 Die Sicherheits-DLL hat den Remotebenutzer, der vom UserName-Mitglied identifiziert wurde, erfolgreich authentifiziert. Der RAS-Server fährt mit seiner PPP-Authentifizierung fort.
SECURITYMSG_FAILURE
 Die Sicherheits-DLL verweigerte den Zugriff auf den Remotebenutzer, der vom UserName-Mitglied identifiziert wurde. Der RAS-Server legt den Aufruf auf und zeichnet die fehlgeschlagene Authentifizierung im Ereignisprotokoll auf.
SECURITYMSG_ERROR
 Es ist ein Fehler aufgetreten, der die Überprüfung des Remotebenutzers verhindert hat. Der RAS-Server legt den Aufruf auf und zeichnet den Fehler im Ereignisprotokoll auf.

hPort

Gibt das Porthandle an, das der RAS-Server im RasSecurityDialogBegin-Aufruf für diese Authentifizierungstransaktion an die Sicherheits-DLL übergeben hat.

dwError

Gibt einen Fehlercode an. Wenn dwMsgId SECURITYMSG_ERROR ist, legen Sie dwError auf einen der in Winerror.h oder Raserror.h definierten Fehlercodes ungleich null fest. Der RAS-Server zeichnet diesen Fehlercode im Ereignisprotokoll auf. Wenn der dwMsgId-Member auf Erfolg oder Fehler hinweist, legen Sie dwError auf Null fest.

UserName[UNLEN + 1]

Gibt den Namen des Remotebenutzers an, wenn dwMsgId SECURITYMSG_SUCCESS oder SECURITYMSG_FAILURE ist. Diese Zeichenfolge kann leer sein, wenn dwMsgId SECURITYMSG_ERROR ist.

Domain[DNLEN + 1]

Gibt den Namen der Anmeldedomäne für den Remotebenutzer an, wenn dwMsgId SECURITYMSG_SUCCESS oder SECURITYMSG_FAILURE ist. Diese Zeichenfolge kann leer sein, wenn dwMsgId SECURITYMSG_ERROR ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile rasshost.h

Weitere Informationen

RAS-Server-Verwaltungsstrukturen

RasSecurityDialogBegin

RasSecurityDialogComplete

Übersicht über ras (Remote Access Service, RAS)