RasCustomDialFn-Rückruffunktion (ras.h)
[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 |
|---|---|
|
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 |