На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

RasDialDlg



[New - Windows NT]

The RasDialDlg function tries to establish a RAS connection using a specified phone-book entry and the credentials of the logged-on user. The function displays a stream of dialog boxes that indicate the state of the connection operation.

BOOL RasDialDlg(

LPTSTR lpszPhonebook, // pointer to the full path and filename of the phone-book file
LPTSTR lpszEntry, // pointer to the name of the phone-book entry to dial
LPTSTR lpszPhoneNumber, // pointer to replacement phone number to dial
LPRASDIALDLG lpInfo // pointer to a structure that contains additional parameters
);


Parameters

lpszPhonebook

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.

lpszEntry

Pointer to a null-terminated string that contains the name of the phone-book entry to dial.

lpszPhoneNumber

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.

lpInfo

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.



Return Values

If the function establishes a RAS connection, the return value is a nonzero value.
If an error occurs, or if the user selects the Cancel button during the dialing operation, the return value is zero. If an error occurs, the dwError member of the RASDIALDLG structure returns a nonzero system or RAS error code.

Remarks

The RasDialDlg function displays a stream of dialog boxes that are similar to the dialog boxes that main Dial-Up Networking dialog box displays when the user selects the Dial button. The RasDialDlg function is useful for applications in which you want to display a standard user interface for a connection operation without presenting the main phone-book dialog box. For example, the RAS AutoDial service uses this function to establish a connection using the phone-book entry associated with a remote address.

The RasDialDlg function displays dialog boxes during the connection operation to provide feedback to the user about the progress of the operation. For example, the dialog boxes might indicate when the operation is dialing, when it is authenticating the user's credentials on the remote server, and so on. The dialog boxes also provide a Cancel button for the user to terminate the operation.
RasDialDlg returns when the connection is established, or when the user cancels the operation.

See Also

RASDIALDLG, RasPhonebookDlg


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

RasDialDlg



[Новый - Windows NT]

Функция RasDialDlg пытается устанавливать связь RAS, использовавшую определенный телефонный-книжный вход и верительные грамоты зарегистрированного-на потребителе. Функция отображает поток диалоговых ящиков, которые указывают состояние действия связи.

BOOL RasDialDlg(

LPTSTR lpszPhonebook, // УКАЗАТЕЛЬ в полный путь и filename телефонного-книжного файла LPTSTR lpszEntry, // указатель в имя телефонного-книжного входа, чтобы набирать LPTSTR lpszPhoneNumber, // указатель в номер телефона замены, чтобы набирать указатель LPRASDIALDLG lpInfo // в структуру, которая содержит дополнительные параметры
);


Параметры

lpszPhonebook

Указатель в недействительный расторгнутую строку, которая определяет полный путь и filename телефонной-книги (.PBK) ФАЙЛ. Если этот параметр НЕДЕЙСТВИТЕЛЕН, функция использует текущий встроенный телефонный-книжный файл. Встроенный телефонный-книжный файл - один выбранное потребителем на листе собственности Предпочтений Потребителя Dial-Up, связывающего диалоговый ящик.

lpszEntry

Указатель в недействительный расторгнутую строку, которая содержит имя телефонного-книжного входа, чтобы набираться.

lpszPhoneNumber

Указатель в недействительный расторгнутую строку, которая содержит номер телефона, который аннулирует числа хранился на телефонном-книжном входе. Если этот параметр НЕДЕЙСТВИТЕЛЕН, RasDialDlg использует числа на телефонном-книжном входе.

lpInfo

Указатель в структуру RASDIALDLG, которая содержит дополнительный вклад и выходные параметры. Во вкладе, член dwSize этой структуры должен определить sizeof(RASDIALDLG). Если ошибка происходит, член dwError возвращает код ошибки; в противном случае, это возвращает нуль.



Обратные Величины

Если функция устанавливает связь RAS, обратная величина является ненулевой величиной.
Если ошибка происходит, или если потребитель выбирается кнопку Отмены в течение набирающего действия, обратная величина нулевая. Если ошибка происходит, член dwError структуры RASDIALDLG возвращает ненулевую систему или код ошибки RAS.

Замечания

Функция RasDialDlg отображает поток диалоговых ящиков, которые подобные диалоговым ящикам, что основа Dial-Up, связывающая диалоговые показы ящика когда потребитель выбирается кнопку Абонента. Функция RasDialDlg полезная для приложений в которых Вы хотите отобразить стандартный интерфейс пользавателя для действия связи не представляя основной телефонный-книжный диалоговый ящик. Например, услуга RAS AutoDial использует эту функцию, чтобы устанавливать связь, использовавшую телефонный-книжный вход связывался дистанционным адресом.

Функция RasDialDlg отображает диалоговые ящики в течение действия связи, чтобы обеспечивать обратную связь потребителю о прогрессе действия. Например, диалог боксирует могло указаться когда операция набирает, когда она удостоверяет верительные грамоты пользователя в дистанционном сервере, и так далее. Диалоговые блоки также обеспечивают кнопку Отмены для пользователя, чтобы завершать операцию.
RasDialDlg ВОЗВРАЩАЕТСЯ когда связь установлена, или когда пользователь отменяет операцию.

Смотри Также

RASDIALDLG, RasPhonebookDlg


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz