Benutzerdefinierte RAS-Skripterstellung
Entwickler können eine benutzerdefinierte Skripterstellungs-DLL erstellen, die sich auf einem RAS-Clientcomputer befindet. Diese DLL kann während des Verbindungsvorgangs mit dem Server kommunizieren.
Windows NT: Benutzerdefinierte Skripts sind nicht verfügbar.
Einrichten der DLL
Erstellen Sie zum Einrichten der DLL einen Wert mit dem Namen CustomScriptDllPath unter dem folgenden Registrierungsschlüssel:
HKEY_LOCAL_MACHINE
System
CurrentControlSet
Services
Rasman
Parameters
Dieser Wert sollte vom Typ REG _ EXPAND SZ _ sein. Der Wert sollte den Pfad zur DLL für benutzerdefinierte Skripts enthalten. Für jeden RAS-Clientcomputer wird nur eine DLL mit benutzerdefinierter Skripterstellung unterstützt.
Interaktion zwischen Server, RAS und der Custom-Scripting DLL
Die benutzerdefinierte Skript-DLL sollte einen einzelnen Einstiegspunkt exportieren: RasCustomScriptExecute. RAS ruft diese Funktion während des interaktiven _ RASCS-Zustands des Verbindungsprozesses auf. Der status "RASCS Interactive" ist ein angehaltener Zustand, der es dem Benutzer ermöglicht, mit einer Benutzeroberfläche zu interagieren, die von der DLL mit benutzerdefinierten _ Skripts dargestellt wird. Weitere Informationen zu Verbindungszuständen finden Sie unter RASCONNSTATE.
RAS über gibt als Parameter an die RasCustomScriptExecute-Funktion weiter:
- Ein Handle für den Port auf dem Clientcomputer, der für die Verbindung verwendet wird.
- Zeichenfolgen, die das Telefonbuch und den Eintrag für die Verbindung identifizieren.
- RAS übergibt auch ein Handle an ein Fenster, damit die DLL eine Benutzeroberfläche präsentieren kann.
- Ein Satz von Funktionsze0ern, die die DLL für die Kommunikation mit dem Server verwenden kann.
Weitere Informationen zu diesen Parametern finden Sie unter RasCustomScriptExecute.
RAS übergibt einen Zeiger auf eine RASCUSTOMSCRIPTEXTENSIONS-Struktur als letzten Parameter an RasCustomScriptExecute. Diese Struktur enthält einen Zeiger auf eine Funktion vom Typ PFNRASSETCOMMSETTINGS. Die DLL für benutzerdefinierte Skripts ruft diese Funktion auf, um die Kommunikationseinstellungen auf dem Port zu ändern, der von der Verbindung verwendet wird.
RAS vermittelt die Interaktion zwischen dem Server und der DLL mit benutzerdefinierten Skripts. In der Regel initiiert der Server den Dialog. Beispielsweise kann der Server den Benutzernamen und das Kennwort des Benutzers anfordern.
Wenn Sie benutzerdefinierte Skripts zum Herstellen einer Verbindung verwenden, muss auf dem Server Windows NT 4.0 oder Windows 2000 ausgeführt werden.
Benutzerdefinierte Skripterstellungs Benutzeroberfläche muss IDCANCEL unterstützen
Wenn das benutzerdefinierte Telefon eine Benutzeroberfläche anzeigt, muss die Benutzeroberfläche WM COMMAND-Nachrichten unterstützen, bei denen _ LOWORD(wParam) IDCANCEL entspricht.
Konfigurieren der Verbindung
Der Einstiegspunkt RasCustomScriptExecute kann von RasDialDlg oder auf Windows XP von RasDial aufgerufen werden.
Legen Sie zum Aufrufen von RasCustomScriptExecute aus RasDialDlgdie Option RASEO CustomScript im Telefonbucheintrag für _ die Verbindung fest. Eine Beschreibung der Optionen für die Telefonbucheingabe finden Sie unter dwfOptions-Mitglied von RASENTRY. Verwenden Sie die Funktionen RasGetEntryProperties und RasSetEntryProperties, um diese Option programmgesteuert festlegen.
Windows XP: Zum Aufrufen von RasCustomScriptExecute aus RasDialmuss der Aufruf von RasDial eine RASDIALEXTENSIONS-Struktur angeben, und diese Struktur muss das RDEOPT _ UseCustomScripting-Flag angeben. Darüber hinaus muss im Telefonbucheintrag für die Verbindung die Option RASEO CustomScript angegeben werden, wie _ im vorherigen Absatz beschrieben.
Aufrufen der DLL für benutzerdefinierte Skripts
Wenn der Benutzer eine Verbindung für einen Telefonbucheintrag aktiviert, für den RASEO CustomScript festgelegt ist, ruft RAS die CUSTOM _ SCRIPTING-DLL auf. In diesem Szenario ruft RAS die DLL mit benutzerdefinierten Skripts von RasDialDlg auf.
Stellen Sie die Verbindung mithilfe der RasDialDlg-Funktion auf, um die DLL für die benutzerdefinierte Skripterstellung programmgesteuert aufrufen zu können. Auf Windows XP ruft die RasDial-Funktion auch die DLL für die benutzerdefinierte Skripterstellung auf.