| |||
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! | |||
| |||
RasDialThe RasDial function establishes a RAS connection between a RAS client and a RAS server. The connection data includes callback and user authentication information. DWORD RasDial( LPRASDIALEXTENSIONS lpRasDialExtensions, // pointer to function extensions data LPTSTR lpszPhonebook, // pointer to full path and filename 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 ); Parameters lpRasDialExtensions Windows NT: Points to a RASDIALEXTENSIONS structure that specifies a set of RasDial extended features to enable. If you do not need to enable any of the extensions, set this parameter to NULL. Windows 95: This parameter is ignored. On Windows 95, RasDial always uses the default behaviors for the RASDIALEXTENSIONS options. lpszPhonebook Windows NT: Pointer to a null-terminated string that specifies the full path and filename 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. Windows 95: This parameter is ignored. Dial-up networking stores phone-book entries in the registry rather than in a phone-book file. lpRasDialParams Points to a RASDIALPARAMS structure that specifies calling parameters for the RAS connection. The caller must set the RASDIALPARAMS structure's dwSize member to the sizeof(RASDIALPARAMS) to identify the version of the structure being passed. dwNotifierType Specifies the nature of the lpvNotifier parameter. If lpvNotifier is NULL, dwNotifierType is ignored. If lpvNotifier is not NULL, set dwNotifierType to one of the following values: Value Meaning 0xFFFFFFFF The lpvNotifier parameter is a handle to a window to receive progress notification messages. In a progress notification message, wParam is the equivalent of the rasconnstate parameter of RasDialFunc and RasDialFunc1, and lParam is the equivalent of the dwError parameter of RasDialFunc and RasDialFunc1. The progress notification message uses a system registered message code. You can obtain the value of this message code as follows: {UINT unMsg = RegisterWindowMessageA( RASDIALEVENT ); if (unMsg == 0) unMsg = WM_RASDIALEVENT; } 0 The lpvNotifier parameter points to a RasDialFunc callback function. 1 The lpvNotifier parameter points to a RasDialFunc1 callback function. 2 Windows NT: The lpvNotifier parameter points to a RasDialFunc2 callback function. lpvNotifier Specifies a window handle or a RasDialFunc, RasDialFunc1, or RasDialFunc2 callback function to receive RasDial event notifications. The dwNotifierType parameter specifies the nature of lpvNotifier. Please refer to its description preceding for further detail. If this parameter is not NULL, RasDial sends the window a message, or calls the callback function, for each RasDial event. Additionally, the RasDial call operates asynchronously: RasDial returns immediately, before the connection is established, and communicates its progress via the window or callback function. If lpvNotifier is NULL, the RasDial call operates synchronously: RasDial does not return until the connection attempt has completed successfully or failed. If lpvNotifier is not NULL, notifications to the window or callback function can occur at any time after the initial call to RasDial. Notifications end when one of the following events occurs: · The connection is established. In other words, the RAS connection state is RASCS_Connected. · The connection fails. In other words, dwError is nonzero. · RasHangUp is called on the connection. The callback notifications are made in the context of a thread captured during the initial call to RasDial. lphRasConn Points to a variable of type HRASCONN. You must set the HRASCONN variable to NULL before calling RasDial. If RasDial succeeds, it stores a handle to the RAS connection into *lphRasConn. Return Values If the function succeeds, the immediate return value is zero. In addition, the function stores a handle to the RAS connection into the variable pointed to by lphRasConn. If the function fails, the immediate return value is a nonzero error value, either from the set listed in the RAS header file or ERROR_NOT_ENOUGH_MEMORY. Remarks Errors that occur after the immediate return can be detected by RasGetConnectStatus. Data is available until an application calls RasHangUp to hang up the connection. An application must eventually call RasHangUp whenever a non-NULL connection handle is stored into *lphRasConn. This applies even if RasDial returns a nonzero (error) value. An application can safely call RasHangUp from a RasDial notifier callback function. If this is done, however, the hangup does not occur until the routine returns. Windows NT: If the structure pointed to by lpRasDialExtensions enables RDEOPT_PausedStates, the RasDial function pauses whenever it enters a state in which the RASCS_PAUSED bit is set to one. To restart RasDial from such a paused state, call RasDial again, passing the connection handle returned from the original RasDial call in *lphRasConn. The same notifier used in the original RasDial call must be used when restarting from a paused state. To specify that RasDial should enter a RASCS_CallbackSetByCaller state, set lpRasDialParams->szCallbackNumber to "*" on the initial call to RasDial. When your notification handler is called with this state, you can set the the callback number to a number supplied by the user. Windows 95: Windows 95 does not support the RASCS_CallbackSetByCaller state or any of the other paused states. See Also RasDialDlg, RasDialFunc, RasDialFunc1, RasDialFunc2, RasGetConnectStatus, RasHangUp, RASDIALEXTENSIONS, RASDIALPARAMS, WM_RASDIALEVENT | |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
| |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
RasDialФункция RasDial устанавливает связи RAS между клиентом RAS и сервер RAS. Данные связи включает возврат и информацию аутентификации пользователя. DWORD RasDial( LPRASDIALEXTENSIONS lpRasDialExtensions, // УКАЗАТЕЛЬ, чтобы функционировать данные расширений LPTSTR lpszPhonebook, // указатель в полный путь и filename телефонного-книжного файла LPRASDIALPARAMS lpRasDialParams, // указатель в данные параметров вызова DWORD dwNotifierType, // определяет тип вручителя события RasDial LPVOID lpvNotifier, // определяет вручителя для событий RasDial указателя LPHRASCONN lphRasConn // в переменную, чтобы получать ручку связи ); Параметры lpRasDialExtensions Windows NT: Точки на структуру RASDIALEXTENSIONS, которые определяют установку RasDial расширял характеристики, чтобы приспосабливаться. Если Вам не нужно приспосабливаться любое из расширений, установите этот параметр на НЕДЕЙСТВИТЕЛЬНЫЙ. Windows 95: Этот параметр проигнорирован. На Windows 95, RasDial всегда использует по умолчанию поведение для опций RASDIALEXTENSIONS. lpszPhonebook Windows NT: Указатель в недействительный расторгнутую строку, которая определяет полный путь и filename телефонной-книги (.PBK) ФАЙЛ. Если этот параметр НЕДЕЙСТВИТЕЛЕН, функция использует текущий по умолчанию телефонный-книжный файл. По умолчанию телефонный-книжный файл - один выбранное пользователем на листе свойства Предпочтений Пользователя Dial-Up, связывающего диалогового блока. Windows 95: Этот параметр проигнорирован. Набор, связывающий загрузку телефонные-книжные данные в регистрации а не в телефонном-книжном файле. lpRasDialParams Точки на структуру RASDIALPARAMS, которые определяют вызов параметров для связи RAS. Вызывающий оператор должен установить RASDIALPARAMS структурного элемента dwSize в sizeof(RASDIALPARAMS), чтобы идентифицировать версию структуры, прохоженной. dwNotifierType Определяет природу параметра lpvNotifier. Если lpvNotifier НЕДЕЙСТВИТЕЛЕН, dwNotifierType проигнорирован. Если lpvNotifier не НЕДЕЙСТВИТЕЛЕН, установивший dwNotifierType в одно из следующего величин: Значение Величины 0xFFFFFFFF параметр lpvNotifier является ручкой в окно, чтобы получать сообщения уведомления прогресса. В сообщении уведомления прогресса, wParam - эквивалент параметра rasconnstate RasDialFunc и RasDialFunc1, и lParam - эквивалент параметра dwError RasDialFunc и RasDialFunc1. Сообщение уведомления прогресса использует систему зарегистрировавшую код сообщения. Вы можете получить величину этого кода сообщения следующим образом: {UINT unMsg = RegisterWindowMessageA( RASDIALEVENT ); если (unMsg == 0) unMsg = WM_RASDIALEVENT; } 0 Параметр lpvNotifier указывает на функцию возврата RasDialFunc. 1 Параметр lpvNotifier указывает на функцию возврата RasDialFunc1. 2 Windows NT: параметр lpvNotifier указывает на функцию возврата RasDialFunc2. lpvNotifier Определяет ручку окна или RasDialFunc, RasDialFunc1, или функция возврата RasDialFunc2, чтобы получать уведомления события RasDial. Параметр dwNotifierType определяет природу lpvNotifier. Пожалуйста ссшлитесь на свое описание, предшествующее для продвигать деталь. Если этот параметр не НЕДЕЙСТВИТЕЛЕН, RasDial посылает окну сообщение или вызывает функцию возврата, для каждого события RasDial. К тому же, вызов RasDial обслуживает асинхронно: возврат RasDial немедленно, прежде, чем связь будет установлена, и передает своему прогрессу через функцию окна или возврата. Если lpvNotifier НЕДЕЙСТВИТЕЛЕН, вызов RasDial обслуживает синхронно: RasDial не возвращается пока попытка связи не завершила успешно или терпела неудачу. Если lpvNotifier не НЕДЕЙСТВИТЕЛЕН, уведомления в окно или функция возврата может произойти в любое время после начального вызова на RasDial. Уведомления заканчиваются когда одно из следующих событий происходит: Связь установлена. Другими словами, состояние связи RAS - RASCS_Connected. Связь терпит неудачу. Другими словами, dwError ненулевой. RasHangUp ПОСЕЩЕН связь. Уведомления возврата сделаны в контексте резьбы захваченной в течение начального вызова на RasDial. lphRasConn Точки на переменную типа HRASCONN. Вы должны установить переменную HRASCONN на НЕДЕЙСТВИТЕЛЬНЫЙ перед разговором RasDial. Если RasDial добивается успеха, это загружает ручку на связь RAS в *lphRasConn. Обратные Величины Если функция добивается успеха, непосредственная обратная величина нулевая. Кроме того, функция загружает ручку на связь RAS в переменную указанную, чтобы lphRasConn. Если функция терпит неудачу, непосредственная обратная величина - ненулевая величина ошибки, или из установки указанной в файле заголовка RAS или ERROR_NOT_ENOUGH_MEMORY. Замечания Ошибки, которые происходят после того, как безотлагательный возврат может быть обнаружен RasGetConnectStatus. Данные доступно пока приложение не вызовет RasHangUp, чтобы отключать связь. Приложение должно в конечном счете вызвать RasHangUp всякий раз, когда не-НЕДЕЙСТВИТЕЛЬНАЯ ручка связи загружена в *lphRasConn. Это относится даже если бы RasDial возвращает ненулевую величину (ошибка). Приложение может благополучно вызвать RasHangUp из RasDial notifier функции возврата. Если это сделан, тем не менее, зависание не происходит пока программа не возвращается. Windows NT: Если структура указывалась бы, чтобы lpRasDialExtensions допустимыми RDEOPT_PausedStates, функциональными паузами RasDial всякий раз, когда она вводит состояние в котором бит RASCS_PAUSED установлен, чтобы один. Для того, чтобы перезапускать RasDial из такого остановившееся состояние, вызовите RasDial снова, передающее ручку связи возвращался из оригинального RasDial приглашаться *lphRasConn. То же notifier использовалось на оригинальном вызове RasDial должно быть использовано при перезапуске из остановленного состояния. Для того, чтобы определять, что RasDial должен вводить состояние RASCS_CallbackSetByCaller, установившее lpRasDialParams->szCallbackNumber на "*" на начальном вызове на RasDial. Когда ваш вручитель уведомления вызван этим состоянием, Вы можете установить номер возврата в число поставленное пользователем. Windows 95: Windows 95 не поддерживает состояние RASCS_CallbackSetByCaller или любое из другое остановившееся состояния. Смотри Также RasDialDlg, RasDialFunc, RasDialFunc1, RasDialFunc2, RasGetConnectStatus, RasHangUp, RASDIALEXTENSIONS, RASDIALPARAMS, WM_RASDIALEVENT | |||
| |||
 |
