Функция RasGetAutodialParamA (ras.h)
Функция RasGetAutodialParam извлекает значение параметра AutoDial.
Синтаксис
DWORD RasGetAutodialParamA(
[in] DWORD unnamedParam1,
[out] LPVOID unnamedParam2,
[in, out] LPDWORD unnamedParam3
);
Параметры
[in] unnamedParam1
Указывает извлекаемый параметр AutoDial. Этот параметр может принимать одно из указанных ниже значений.
Значение | Значение |
---|---|
|
Параметр lpvValue возвращает значение DWORD . Если это значение равно нулю (по умолчанию), autoDial отображает диалоговое окно для запроса пользователя перед созданием подключения. Если это значение равно 1 и в базе данных AutoDial есть запись телефонной книги для набора, autoDial создает подключение без отображения диалогового окна. |
|
Параметр lpvValue возвращает значение DWORD . Если это значение равно 1, система отключает все подключения autoDial для текущего сеанса входа. Если это значение равно нулю (по умолчанию), автоматические подключения включены. Системная служба AutoDial изменяет это значение на ноль, когда новый пользователь входит на рабочую станцию. |
|
Параметр lpvValue возвращает значение DWORD , указывающее максимальное количество адресов, которые AutoDial хранит в реестре. AutoDial сначала хранит адреса, которые использовались для создания подключения autoDial; затем в нем хранятся адреса, полученные после создания подключения RAS. Адреса, написанные с помощью функции RasSetAutodialAddress , всегда сохраняются и не включаются в вычисление ограничения. По умолчанию используется значение 100. |
|
Параметр lpvValue возвращает значение DWORD , указывающее время ожидания в секундах. Если попытка автоматического подключения завершается сбоем, системная служба AutoDial отключает последующие попытки достижения того же адреса в течение периода ожидания. Это предотвращает отображение приложением нескольких диалоговых окон подключения для одного и того же логического запроса. Значение по умолчанию — 5. |
|
Параметр lpvValue указывает на значение DWORD , указывающее время ожидания в секундах. Перед попыткой автоматического подключения система отобразит диалоговое окно с запросом пользователя на подтверждение того, что система должна набирать номер. В диалоговом окне есть таймер обратного отсчета, который завершает диалог с выбором "Не набирать", если пользователь не выполняет никаких действий. Значение DWORD , на которое указывает lpvValue, указывает начальное время этого таймера обратного отсчета. |
[out] unnamedParam2
Указатель на буфер, получающий значение указанного параметра.
[in, out] unnamedParam3
Указатель на значение DWORD .
При входе задайте это значение, чтобы указать размер буфера lpvValue (в байтах).
В выходных данных это значение указывает фактический размер значения, записанного в буфер.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.
Если функция завершается ошибкой, возвращается один из следующих кодов ошибок или значение из кода ошибок маршрутизации и удаленного доступа или Winerror.h.
Значение | Значение |
---|---|
|
Недопустимый параметр dwKey или lpvValue . |
|
Размер, заданный значением lpdwcbValue , слишком мал. |
Комментарии
Примечание
Заголовок ras.h определяет RasGetAutodialParam в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | ras.h |
Библиотека | Rasapi32.lib |
DLL | Rasapi32.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по