RasCustomScriptExecuteFn-Rückruffunktion (ras.h)

Artikel
03/01/2024

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