RasSecurityDialogBegin-Funktion (rasshost.h)

Artikel
08/25/2023

Die RasSecurityDialogBegin-Funktion ist ein RAS-Sicherheits-DLL-Einstiegspunkt eines Drittanbieters, den der RAS-Server aufruft, wenn ein Remotebenutzer versucht, eine Verbindung herzustellen. Dadurch kann die Sicherheits-DLL mit der Authentifizierung des Remotebenutzers beginnen.

Hinweis Windows Server 2008, Windows Server 2003, Windows 2000 Server und Windows NT Server 4.0 bieten derzeit nur Unterstützung für RAS-Sicherheitshosts für serielle Geräte. Andere Arten von Verbindungen, z. B. ISDN-Verbindungen (Integrated Services Digital Network) oder VPN-Verbindungen (Virtual Private Network), werden nicht unterstützt.

Syntax

DWORD RasSecurityDialogBegin(
  [in] HPORT                        hPort,
  [in] PBYTE                        pSendBuf,
  [in] DWORD                        SendBufSize,
  [in] PBYTE                        pRecvBuf,
  [in] DWORD                        RecvBufSize,
       VOID(* )(SECURITY_MESSAGE *) RasSecurityDialogComplete
);

Parameter

[in] hPort

Gibt ein RAS-Porthandle an. Die Sicherheits-DLL verwendet dieses Handle in anderen RAS-Sicherheitsfunktionen, z. B . RasSecurityDialogSend und RasSecurityDialogReceive, um diese Authentifizierungstransaktion zu identifizieren.

Beachten Sie, dass dieses Handle nur in RAS-Sicherheitsfunktionen gültig ist. nicht in anderen E/A-Funktionen verwenden.

[in] pSendBuf

Zeiger auf einen vom RAS-Server zugeordneten Puffer. Die Sicherheits-DLL verwendet diesen Puffer mit der RasSecurityDialogSend-Funktion , um Text zu senden, der im RAS-Terminalfenster auf dem Remotecomputer angezeigt wird.

[in] SendBufSize

Gibt die Größe des pSendBuf-Puffers in Bytes an.

[in] pRecvBuf

Zeiger auf einen vom RAS-Server zugeordneten Puffer. Die Sicherheits-DLL verwendet diesen Puffer mit der RasSecurityDialogReceive-Funktion , um die Antwort vom Remotebenutzer zu empfangen.

[in] RecvBufSize

Gibt die Größe des pRecvBuf-Puffers in Bytes an.

RasSecurityDialogComplete

Rückgabewert

Wenn die Sicherheits-DLL den Authentifizierungsvorgang erfolgreich startet, sollte RasSecurityDialogBeginNO_ERROR zurückgeben. In diesem Fall muss die Sicherheits-DLL die Authentifizierungstransaktion später beenden, indem die Funktion aufgerufen wird, auf die der RasSecurityDialogComplete-Parameter verweist.

Wenn ein Fehler auftritt, sollte RasSecurityDialogBegin einen Fehlercode ungleich null zurückgeben. In diesem Fall legt der RAS-Server den Aufruf auf und zeichnet den Fehler im Ereignisprotokoll auf. Wenn ein Fehlercode ungleich null zurückgegeben wird, wird die Authentifizierungstransaktion beendet, sodass die Sicherheits-DLL die RasSecurityDialogComplete-Funktion nicht aufrufen muss.

Hinweise

Wenn ein RAS-Server einen Aufruf von einem Remotecomputer empfängt, ruft er die RasSecurityDialogBegin-Funktion auf, die von der registrierten RAS-Sicherheits-DLL exportiert wird, sofern vorhanden. Wenn der RAS-Server diese Funktion aufruft, übergibt er die folgenden Informationen an die Sicherheits-DLL:

Ein Porthandle zum Identifizieren der Verbindung
Zeiger auf Puffer, die bei der Kommunikation mit dem Remotebenutzer verwendet werden sollen
Ein Zeiger auf die RasSecurityDialogComplete-Funktion , die nach Abschluss der Authentifizierung aufgerufen werden soll.

Das Porthandle und die Pufferzeiger sind gültig, bis RasSecurityDialogComplete aufgerufen wird, um die Authentifizierungstransaktion zu beenden.

Die RasSecurityDialogBegin-Implementierung muss so schnell wie möglich zurückgegeben werden, da der RAS-Server blockiert ist und keine weiteren Aufrufe annehmen kann, bis RasSecurityDialogBegin zurückgegeben wird. Die RasSecurityDialogBegin-Funktion sollte die Eingabeparameter kopieren und einen Thread erstellen, um mit dem Remotebenutzer zu kommunizieren und zu authentifizieren.

Anforderungen

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

Weitere Informationen

RAS-Server-Verwaltungsfunktionen

RasSecurityDialogComplete

RasSecurityDialogReceive

RasSecurityDialogSend

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

Freigeben über