RasSecurityDialogBegin-Funktion (rasshost.h)

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.

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.

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

Weitere Informationen

RAS-Server-Verwaltungsfunktionen

RasSecurityDialogComplete

RasSecurityDialogReceive

RasSecurityDialogSend

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