RasCustomDialDlgFn-Rückruffunktion (rasdlg.h)

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

]

Die RasCustomDialDlg-Funktion ist eine anwendungsdefinierte Funktion, die von einer benutzerdefinierten Wähl-DLL eines Drittanbieters exportiert wird. Mit dieser Funktion können Drittanbieter benutzerdefinierte RAS-Verbindungsdialogfelder implementieren.

Syntax

RasCustomDialDlgFn Rascustomdialdlgfn;

BOOL Rascustomdialdlgfn(
  HINSTANCE hInstDll,
  DWORD dwFlags,
  LPWSTR lpszPhonebook,
  LPWSTR lpszEntry,
  LPWSTR lpszPhoneNumber,
  LPRASDIALDLG lpInfo,
  PVOID pvInfo
)
{...}

Parameter

hInstDll

Handle mit der instance der dll für benutzerdefinierte Wählzeichen, die geladen wurde.

dwFlags

Eine Reihe von Bitflags, die RasCustomDialDlg-Optionen angeben.

Wert

Bedeutung

RCD_Logon

Wenn dieses Flag auf eins festgelegt ist, wurde die Verbindung aus einem Windows-Anmeldekontext hergestellt. RasDial verwendet diese Informationen, um die entsprechenden Benutzereinstellungen für den Verbindungseintrag abzurufen. Wenn RasDial von diesem Einstiegspunkt aufgerufen wird, muss für den dwfOptions-Member des lpRasDialExtension-Parameters das flag RDEOPT_NoUser festgelegt sein, um anzugeben, dass die Verbindung aus einem Windows-Anmeldekontext hergestellt wurde.

 

Windows Server 2003 und Windows XP/2000: Dieser Parameter ist reserviert und sollte nicht verwendet werden.

lpszPhonebook

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

lpszEntry

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Telefonbucheintrags für das Wählen enthält.

lpszPhoneNumber

Zeiger auf eine NULL-endende Zeichenfolge, die eine Telefonnummer enthält, die die im Telefonbucheintrag gespeicherten Nummern überschreibt. Wenn dieser Parameter NULL ist, verwendet RasDialDlg die Nummern im Telefonbucheintrag.

lpInfo

Zeiger auf eine RASDIALDLG-Struktur , die zusätzliche Eingabe- und Ausgabeparameter enthält. Bei der Eingabe muss der dwSize-Member dieser Struktur sizeof( RASDIALDLG) angeben. Wenn ein Fehler auftritt, gibt der dwError-Member einen Fehlercode zurück. Andernfalls wird 0 (null) zurückgegeben.

pvInfo

Für die interne Verwendung reserviert. Dieser Parameter ist immer NULL.

Rückgabewert

Wenn der Benutzer einen Telefonbucheintrag erstellt, kopiert oder bearbeitet, sollte der Rückgabewert TRUE sein. Andernfalls sollte die Funktion FALSE zurückgeben.

Wenn ein Fehler auftritt, sollte RasCustomEntryDlg den dwError-Member der RASENTRYDLG-Struktur auf einen Wert aus Routing- und RAS-Fehlercodes oder Winerror.h festlegen.

Hinweise

RAS ruft diesen Einstiegspunkt von RasDialDlg auf, wenn der szCustomDialDll-Member der RASENTRY-Struktur für den gewählten Eintrag eine benutzerdefinierte Wähl-DLL angibt.

Wenn dieser Einstiegspunkt RasDial aufruft, darf der parameter lpRasDialExtensions nicht NULL sein, und für den dwfOptions-Member der RASDIALEXTENSIONS-Struktur muss das flag RDEOPT_CustomDial festgelegt sein.

Das Dialogfeld für benutzerdefinierte Wählvorgänge muss WM_COMMAND Nachrichten unterstützen, wobei LOWORD(wParam) IDCANCEL entspricht.

Wenn die benutzerdefinierte Wähl-DLL diesen Einstiegspunkt nicht unterstützt, gibt RAS ERROR_CANNOT_DO_CUSTOMDIAL an den Aufrufer von RasDialDlg zurück.

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	rasdlg.h

Weitere Informationen

Benutzerdefinierte Dialer

RASENTRY

RasCustomDial

RasCustomEntryDlg

RasCustomHangUp

RasDialDlg

Übersicht über ras (Remote Access Service, RAS)

Funktionen des RAS-Diensts