Platform SDK: RAS/Routing and RAS |
The RasCustomDial 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 remote-access dialing routines.
DWORD (WINAPI * RasCustomDial) ( HINSTANCE hInstDll, // handle to DLL instance LPRASDIALEXTENSIONS lpRasDialExtensions, // pointer to // function extensions data LPCTSTR lpszPhonebook, // pointer to full path // and file name of // phone-book file LPRASDIALPARAMS lpRasDialParams, // pointer to calling // parameters data DWORD dwNotifierType, // specifies type of // RasDial event handler LPVOID lpvNotifier, // specifies a handler // for RasDial events LPHRASCONN lphRasConn // pointer to variable // to receive connection handle );
The caller must set the RASDIALPARAMS structure's dwSize member to sizeof(RASDIALPARAMS) to identify the version of the structure being passed.
If the function succeeds, the immediate return value should be zero. In addition, the function should store a handle to the RAS connection into the variable pointed to by the lphRasConn parameter.
If the function fails, the immediate return value should be a nonzero error value, either from the set listed in Raserror.h or ERROR_NOT_ENOUGH_MEMORY.
RAS calls this entry point from RasDial, if the szCustomDialDll member of the RASENTRY structure for the entry being dialed specifies a custom-dialing DLL.
If this entry point calls RasDial, the lpRasDialExtensions parameter must not be NULL, and the dwFlags member of the RASDIALEXTENSIONS structure must have the RDEOPT_CustomDial flag set.
If the custom-dial DLL does not support this entry point, RAS returns ERROR_CANNOT_DO_CUSTOMDIAL to the caller of RasDial.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Unsupported.
Header: Declared in Ras.h.
Unicode: Declared as Unicode and ANSI prototypes.
Remote Access Service (RAS) Overview, Remote Access Service Functions, RasCustomDialDlg, RasCustomEntryDlg, RasCustomHangUp, RasDial, RASENTRY