Функция RasSetAutodialParamA (ras.h)
Функция RasSetAutodialParam задает значение параметра AutoDial.
Синтаксис
DWORD RasSetAutodialParamA(
[in] DWORD unnamedParam1,
[out] LPVOID unnamedParam2,
[in] DWORD unnamedParam3
);
Параметры
[in] unnamedParam1
Задает заданный параметр AutoDial. Этот параметр может быть одним из следующих значений.
| Ценность | Значение |
|---|---|
|
Параметр lpvValue указывает на значение DWORD. Если это значение равно нулю (по умолчанию), автодиал отображает диалоговое окно для запроса пользователя перед созданием подключения. Если это значение равно одному, а в базе данных AutoDial есть запись телефонной книги для набора, автодиал создает подключение без отображения диалогового окна. |
|
Параметр lpvValue указывает на значение DWORD. Если это значение равно одному, система отключает все подключения autoDial для текущего сеанса входа. Если это значение равно нулю (по умолчанию), включены автоматические подключения. Служба автоматической системы изменяет это значение на нулевое, когда новый пользователь входит в рабочую станцию. |
|
Параметр lpvValue указывает на значение DWORD, указывающее максимальное количество адресов, которые хранятся в реестре автоматически. Автодиал сначала сохраняет адреса, используемые для создания автоматического подключения; затем он сохраняет адреса, полученные после создания подключения RAS. Адреса, написанные с помощью функции RasSetAutodialAddress, всегда сохраняются и не включаются в вычисление предела. Значение по умолчанию — 100. |
|
Параметр lpvValue указывает на значение DWORD, указывающее время ожидания в секундах. При сбое попытки автодиалного подключения служба системы автодиал отключает последующие попытки достичь того же адреса в течение периода ожидания. Это предотвращает отображение нескольких диалоговых окон подключения для одного логического запроса приложением. Значение по умолчанию — пять. |
|
Параметр lpvValue указывает на значение DWORD, указывающее время ожидания в секундах. Перед попыткой автоматического подключения система отобразит диалоговое окно с просьбой пользователя подтвердить, что система должна набирать телефон. В диалоговом окне есть таймер отсчета, который завершает диалоговое окно с выбранным параметром "Не набирать", если пользователь не принимает никаких действий. Значение DWORD, на которое указывает lpvValue, указывает начальное время для этого таймера отсчета. |
[out] unnamedParam2
Указатель на буфер, содержащий новое значение для указанного параметра.
[in] unnamedParam3
Задает размер в байтах значения в буфере lpvValue.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение ERROR_SUCCESS.
Если функция завершается ошибкой, возвращаемое значение является одним из следующих кодов ошибок или значения из кодов ошибок маршрутизации и удаленного доступа или Winerror.h.
| Ценность | Значение |
|---|---|
|
Недопустимый параметр dwKey или lpvValue. |
|
Недопустимый размер, указанный dwcbValue. |
Замечания
Заметка
Заголовок ras.h определяет RasSetAutodialParam как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | ras.h |
| библиотеки |
Rasapi32.lib |
| DLL | Rasapi32.dll |
См. также
Обзор службы удаленного доступа (RAS)