RasCustomDialFn-Rückruffunktion (ras.h)

Artikel
08/25/2023

[Diese Funktion ist ab Windows Server 2008 nicht verfügbar.

]

Die RasCustomDial-Funktion ist eine anwendungsdefinierte Funktion, die von einer benutzerdefinierten DLL eines Drittanbieters exportiert wird. Mit dieser Funktion können Drittanbieter benutzerdefinierte Remotezugriffswählroutinen implementieren.

Syntax

RasCustomDialFn Rascustomdialfn;

DWORD Rascustomdialfn(
  HINSTANCE hInstDll,
  LPRASDIALEXTENSIONS lpRasDialExtensions,
  LPCWSTR lpszPhonebook,
  LPRASDIALPARAMS lpRasDialParams,
  DWORD dwNotifierType,
  LPVOID lpvNotifier,
  LPHRASCONN lphRasConn,
  DWORD dwFlags
)
{...}

Parameter

hInstDll

Behandeln Sie die instance der dll für benutzerdefinierte Wählzeichen, die geladen wurde.

lpRasDialExtensions

Zeiger auf eine RASDIALEXTENSIONS-Struktur , die eine Reihe erweiterter RasDial-Features angibt, die aktiviert werden sollen. Legen Sie diesen Parameter auf NULL fest, wenn die Erweiterungen nicht aktiviert werden müssen.

lpszPhonebook

Zeiger auf eine NULL-beendete Zeichenfolge, die den vollständigen Pfad und Dateinamen einer Telefonbuchdatei (PBK) angibt. Wenn dieser Parameter NULL ist, verwendet die Funktion die aktuelle Standard-Telefonbuchdatei. Die Standard-Telefonbuchdatei wird vom Benutzer im Eigenschaftenblatt Benutzereinstellungen des DialogfeldsDFÜ-Netzwerk ausgewählt.

lpRasDialParams

Zeiger auf eine RASDIALPARAMS-Struktur , die Aufrufparameter für die RAS-Verbindung angibt.

Der Aufrufer muss den dwSize-Member der RASDIALPARAMS-Struktur auf sizeof(RASDIALPARAMS) festlegen, um die Version der übergebenen Struktur zu identifizieren.

dwNotifierType

Dieser Parameter ist mit dem dwNotifierType-Parameter für die RasDial-Funktion identisch. Weitere Informationen finden Sie auf der RasDial-Referenzseite .

lpvNotifier

Dieser Parameter ist mit dem lpvNotifier-Parameter für die RasDial-Funktion identisch. Weitere Informationen finden Sie auf der RasDial-Referenzseite .

lphRasConn

Zeiger auf eine Variable vom Typ HRASCONN. Legen Sie die HRASCONN-Variable auf NULL fest, bevor Sie RasDial aufrufen. Wenn RasDial erfolgreich ist, speichert es ein Handle für die RAS-Verbindung in *lphRasConn.

dwFlags

Dieser Parameter ist für die zukünftige Verwendung reserviert.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS und ein Handle für die RAS-Verbindung in der Variablen zurückgegeben, auf die vom lphRasConn-Parameter verwiesen wird.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes oder ein Wert aus Routing- und RAS-Fehlercodes oder Winerror.h.

Wert	Bedeutung
ERROR_NOT_ENOUGH_MEMORY	Die Funktion konnte nicht genügend Arbeitsspeicher zuweisen, um den Vorgang abzuschließen.

Hinweise

RAS ruft diesen Einstiegspunkt von RasDial auf, wenn das szCustomDialDll-Element der RASENTRY-Struktur für den zu wählenden Eintrag eine benutzerdefinierte DLL angibt.

Wenn dieser Einstiegspunkt RasDial aufruft, darf der lpRasDialExtensions-Parameter nicht NULL sein, und für das dwFlags-Element der RASDIALEXTENSIONS-Struktur muss das RDEOPT_CustomDial-Flag festgelegt sein.

Wenn die DLL für benutzerdefiniertes Wählen diesen Einstiegspunkt nicht unterstützt, gibt RAS ERROR_CANNOT_DO_CUSTOMDIAL an den Aufrufer von RasDial zurück.

Anforderungen


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