RasCustomScriptExecuteFn-Rückruffunktion (ras.h)
RAS ruft die RasCustomScriptExecute-Funktion auf, wenn eine Verbindung für einen Telefonbucheintrag hergestellt wird, für den die Option RASEO_CustomScript festgelegt ist.
Syntax
RasCustomScriptExecuteFn Rascustomscriptexecutefn;
DWORD Rascustomscriptexecutefn(
[in] HANDLE hPort,
[in] LPCWSTR lpszPhonebook,
[in] LPCWSTR lpszEntryName,
[in] PFNRASGETBUFFER pfnRasGetBuffer,
[in] PFNRASFREEBUFFER pfnRasFreeBuffer,
[in] PFNRASSENDBUFFER pfnRasSendBuffer,
[in] PFNRASRECEIVEBUFFER pfnRasReceiveBuffer,
[in] PFNRASRETRIEVEBUFFER pfnRasRetrieveBuffer,
[in] HWND hWnd,
[in] RASDIALPARAMS *pRasDialParams,
PVOID pvReserved
)
{...}
Parameter
[in] hPort
Handle an den Port, an dem die Verbindung hergestellt wird. Verwenden Sie dieses Handle beim Senden oder Empfangen von Daten am Port.
[in] lpszPhonebook
Zeiger auf eine Unicode-Zeichenfolge, die den Pfad zu dem Telefonbuch enthält, in dem sich der Eintrag für die Verbindung befindet.
[in] lpszEntryName
Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Eintrags enthält, der zum Herstellen der Verbindung gewählt wurde.
[in] pfnRasGetBuffer
Zeiger auf eine Funktion vom Typ PFNRASGETBUFFER. Die DLL für benutzerdefinierte Skripts sollte diese Funktion verwenden, um Arbeitsspeicher zuzuweisen, um Daten an den Server zu senden.
[in] pfnRasFreeBuffer
Zeiger auf eine Funktion vom Typ PFNRASFREEBUFFER. Die DLL für benutzerdefinierte Skripts sollte diese Funktion verwenden, um den von der pfnRasGetBuffer-Funktion zugeordneten Arbeitsspeicher freizugeben.
[in] pfnRasSendBuffer
Zeiger auf eine Funktion vom Typ PFNRASSENDBUFFER. Die DLL für benutzerdefinierte Skripts verwendet diese Funktion, um mit dem Server über den angegebenen Port zu kommunizieren.
[in] pfnRasReceiveBuffer
Zeiger auf eine Funktion vom Typ PFNRASRECEIVEBUFFER. Die DLL für benutzerdefinierte Skripts verwendet diese Funktion, um mit dem Server über den angegebenen Port zu kommunizieren.
[in] pfnRasRetrieveBuffer
Zeiger auf eine Funktion vom Typ PFNRASRETRIEVEBUFFER. Die DLL für benutzerdefinierte Skripts verwendet diese Funktion, um mit dem Server über den angegebenen Port zu kommunizieren.
[in] hWnd
Handle für ein Fenster, das die benutzerdefinierte Skript-DLL verwenden kann, um dem Benutzer eine Benutzeroberfläche zu präsentieren.
[in] pRasDialParams
Zeiger auf eine Unicode RASDIALPARAMS-Struktur . Diese Struktur enthält die Anmeldeinformationen für die Authentifizierung für den Benutzer. Die DLL für benutzerdefinierte Skripts kann die Member szUserName, szPassword und szDomain dieser Struktur ändern. Das Point-to-Point-Protokoll (PPP) verwendet alles, was in diesen Membern gespeichert ist, wenn RasCustomScriptExecute zurückgibt.
pvReserved
Rückgabewert
Wenn die Funktion erfolgreich ist, sollte der Rückgabewert ERROR_SUCCESS sein.
Wenn die Funktion fehlschlägt, sollte der Rückgabewert ein geeigneter Fehlercode aus Winerror.h oder Raserror.h sein.
Hinweise
Wenn RAS RasCustomScriptExecute aufruft, zeigt der Parameter pRasDialParams auf die Unicode-Struktur RASDIALPARAMS . Das heißt, die Struktur enthält nur Unicode-Zeichenfolgen.
In einigen Fällen ist der szUserName der RASDIALPARAMS-Struktur eine leere Zeichenfolge. In diesen Fällen sollte die DLL für benutzerdefinierte Skripterstellung die Unicode-Version der GetUserName-Funktion verwenden, um den Namen des aktuellen Benutzers abzurufen.
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 | ras.h |