Функция RasSetAutodialParamA (ras.h)

  • Статья

Функция RasSetAutodialParam задает значение параметра AutoDial.

Синтаксис

DWORD RasSetAutodialParamA(
  [in]  DWORD  unnamedParam1,
  [out] LPVOID unnamedParam2,
  [in]  DWORD  unnamedParam3
);

Параметры

[in] unnamedParam1

Задает параметр AutoDial, который необходимо задать. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
RASADP_DisableConnectionQuery
 Параметр lpvValue указывает на значение DWORD . Если это значение равно нулю (по умолчанию), autoDial отображает диалоговое окно для запроса пользователя перед созданием подключения. Если это значение равно 1 и в базе данных AutoDial есть запись телефонной книги для набора, autoDial создает подключение без отображения диалогового окна.
RASADP_LoginSessionDisable
 Параметр lpvValue указывает на значение DWORD . Если это значение равно одному, система отключает все подключения autoDial для текущего сеанса входа. Если это значение равно нулю (по умолчанию), автоматические подключения включены. Системная служба AutoDial изменяет это значение на ноль, когда новый пользователь входит на рабочую станцию.
RASADP_SavedAddressesLimit
 Параметр lpvValue указывает на значение DWORD , указывающее максимальное количество адресов, которые autoDial хранит в реестре. AutoDial сначала хранит адреса, которые использовались для создания подключения autoDial; затем в нем хранятся адреса, полученные после создания подключения RAS. Адреса, написанные с помощью функции RasSetAutodialAddress , всегда сохраняются и не включаются в вычисление ограничения. По умолчанию используется значение 100.
RASADP_FailedConnectionTimeout
 Параметр lpvValue указывает на значение DWORD , указывающее время ожидания в секундах. Если попытка автоматического подключения завершается сбоем, системная служба AutoDial отключает последующие попытки достижения того же адреса в течение периода ожидания. Это предотвращает отображение приложением нескольких диалоговых окон подключения для одного и того же логического запроса. Значение по умолчанию — пять.
RASADP_ConnectionQueryTimeout
 Параметр lpvValue указывает на значение DWORD , указывающее время ожидания в секундах. Перед попыткой автоматического подключения система отобразит диалоговое окно с запросом пользователя на подтверждение того, что система должна набирать номер. В диалоговом окне есть таймер обратного отсчета, который завершает диалог с выбором "Не набирать", если пользователь не выполняет никаких действий. Значение DWORD , на которое указывает lpvValue, указывает начальное время этого таймера обратного отсчета.

[out] unnamedParam2

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

[in] unnamedParam3

Указывает размер (в байтах) значения в буфере lpvValue .

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается ошибкой, возвращается один из следующих кодов ошибок или значение из кода ошибок маршрутизации и удаленного доступа или Winerror.h.

Значение Значение
ERROR_INVALID_PARAMETER
 Недопустимый параметр dwKey или lpvValue .
ERROR_INVALID_SIZE
 Недопустимый размер, заданный dwcbValue .

Комментарии

Примечание

Заголовок ras.h определяет RasSetAutodialParam в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ras.h
Библиотека Rasapi32.lib
DLL Rasapi32.dll

См. также раздел

RasGetAutodialParam

RasSetAutodialAddress

Обзор службы удаленного доступа (RAS)

Функции службы удаленного доступа