Scripting personalizzato RAS

Gli sviluppatori possono creare una DLL di scripting personalizzata che si trova in un computer client RAS. Questa DLL può comunicare con il server durante il processo di creazione di una connessione.

Windows NT: Lo scripting personalizzato non è disponibile.

Configurazione della DLL

Per configurare la DLL, creare un valore con il nome CustomScriptDllPath nella chiave del Registro di sistema seguente:

HKEY_LOCAL_MACHINE
   System
      CurrentControlSet
         Services
            Rasman
               Parameters

Questo valore deve essere di tipo REG_EXPAND_SZ. Il valore deve contenere il percorso della DLL di scripting personalizzato. Per ogni computer client RAS è supportata solo una DLL di scripting personalizzata.

Interazione tra server, RAS e dll Custom-Scripting

La DLL di scripting personalizzata deve esportare un singolo punto di ingresso: RasCustomScriptExecute. RAS chiama questa funzione durante lo stato di RASCS_Interactive del processo di connessione. Lo stato RASCS_Interactive è uno stato sospeso, che consente all'utente di interagire con un'interfaccia utente presentata dalla DLL di scripting personalizzata. Per altre informazioni sugli stati di connessione, vedere RASCONNSTATE .

RAS passerà come parametri alla funzione RasCustomScriptExecute :

• Handle alla porta nel computer client usato per la connessione.
• Stringhe che identificano la rubrica telefonica e la voce per la connessione.
• RAS passa anche un handle a una finestra per abilitare la DLL per presentare un'interfaccia utente.
• Set di puntatori di funzione che la DLL può usare per comunicare con il server.

Per altre informazioni su questi parametri, vedere RasCustomScriptExecute .

RAS passa un puntatore a una struttura RASCUSTOMSCRIPTEXTENSIONS come ultimo parametro a RasCustomScriptExecute. Questa struttura contiene un puntatore a una funzione di tipo PFNRASSETCOMMSETTINGS. La DLL di scripting personalizzata chiama questa funzione per modificare le impostazioni di comunicazione sulla porta usata dalla connessione.

RAS media l'interazione tra il server e la DLL di scripting personalizzato. In genere, il server avvia la finestra di dialogo. Ad esempio, il server può richiedere il nome utente e la password dell'utente.

Quando si usa lo scripting personalizzato per stabilire una connessione, il server non deve eseguire Windows NT 4.0 o Windows 2000.

L'interfaccia utente di scripting personalizzata deve supportare IDCANCEL

Se il dialer personalizzato visualizza un'interfaccia utente, l'interfaccia utente deve supportare i messaggi WM_COMMAND in cui LOWORD(wParam) è uguale a IDCANCEL.

Configurazione della connessione

Il punto di ingresso RasCustomScriptExecute può essere richiamato da RasDialDlg o, in Windows XP, da RasDial.

Per richiamare RasCustomScriptExecute da RasDialDlg, impostare l'opzione RASEO_CustomScript nella voce della rubrica telefonica per la connessione. Per una descrizione delle opzioni di ingresso della rubrica telefonica, vedere il membro dwfOptions di RASENTRY . Usare le funzioni RasGetEntryProperties e RasSetEntryProperties per impostare questa opzione a livello di codice.

Windows XP: Per richiamare RasCustomScriptExecute da RasDial, la chiamata a RasDial deve specificare una struttura RASDIALEXTENSIONS e questa struttura deve specificare il flag di RDEOPT_UseCustomScripting. Inoltre, la voce della rubrica telefonica per la connessione deve specificare l'opzione RASEO_CustomScript come descritto nel paragrafo precedente.

Richiamare la DLL di scripting personalizzata

Se l'utente attiva una connessione per una voce di rubrica telefonica con RASEO_CustomScript impostata, RAS richiama la DLL di scripting personalizzata. In questo scenario RAS richiama la DLL di scripting personalizzata da RasDialDlg.

Per richiamare la DLL di scripting personalizzata a livello di codice, stabilire la connessione usando la funzione RasDialDlg . In Windows XP, la funzione RasDial richiama anche la DLL di scripting personalizzata.