RasCustomDialDlg callback function
[This function is not available as of Windows Server 2008. ]
The RasCustomDialDlg function is an application-defined function that is exported by a third-party custom-dialing DLL. This function allows third-party vendors to implement custom RAS connection dialog boxes.
BOOL WINAPI RasCustomDialDlg( HINSTANCE hInstDll, DWORD dwFlags, LPWSTR lpszPhonebook, LPWSTR lpszEntry, LPWSTR lpszPhoneNumber, LPRASDIALDLG lpInfo, PVOID pvInfo );
Handle to the instance of the custom-dialing DLL that was loaded.
A set of bit flags that specify RasCustomDialDlg options.
If this flag is set to one, the connection was dialed from a Windows Logon context. RasDial uses this information to get the appropriate user preferences for the connection entry. If RasDial is called from this entry point, the dwfOptions member of the lpRasDialExtension parameter must have the RDEOPT_NoUser flag set to indicate the connection was dialed from a Windows Logon context.
Windows Server 2003 and Windows XP/2000: This parameter is reserved and should not be used.
Pointer to a null-terminated string that specifies the full path and file name of a phone-book (PBK) file. If this parameter is NULL, the function uses the current default phone-book file. The default phone-book file is the one selected by the user in the User Preferences property sheet of the Dial-Up Networking dialog box.
Pointer to a null-terminated string that contains the name of the phone-book entry to dial.
Pointer to a null-terminated string that contains a phone number that overrides the numbers stored in the phone-book entry. If this parameter is NULL, RasDialDlg uses the numbers in the phone-book entry.
Pointer to a RASDIALDLG structure that contains additional input and output parameters. On input, the dwSize member of this structure must specify sizeof( RASDIALDLG). If an error occurs, the dwError member returns an error code; otherwise, it returns zero.
Reserved for internal use. This parameter will always be NULL.
If the user creates, copies, or edits a phone-book entry, the return value should be TRUE. Otherwise, the function should return FALSE.
If the custom-dial DLL does not support this entry point, RAS returns ERROR_CANNOT_DO_CUSTOMDIAL to the caller of RasDialDlg.
Minimum supported client
|Windows 2000 Professional [desktop apps only]|
Minimum supported server
|Windows 2000 Server [desktop apps only]|
End of server support
|Windows Server 2003|
Unicode and ANSI names
|RasCustomDialDlgW (Unicode) and RasCustomDialDlgA (ANSI)|
- Remote Access Service (RAS) Overview
- Remote Access Service Functions
- Custom Dialers