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 |
|---|---|
|
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 |