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

Статья
11/20/2024

Функция RasGetAutodialParam извлекает значение параметра AutoDial.

Синтаксис

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

Параметры

[in] unnamedParam1

Задает извлекаемый параметр autoDial. Этот параметр может быть одним из следующих значений.

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

[out] unnamedParam2

Указатель на буфер, получающий значение указанного параметра.

[in, out] unnamedParam3

Указатель на значение DWORD .

Для входных данных задайте это значение, чтобы указать размер в байтах буфера lpvValue.

В выходных данных это значение указывает фактический размер значения, записанного в буфер.

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

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

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

Ценность	Значение
ERROR_INVALID_PARAMETER	Недопустимый параметр dwKey или lpvValue.
ERROR_INVALID_SIZE	Размер, указанный lpdwcbValue слишком мал.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	ras.h
библиотеки	Rasapi32.lib
DLL	Rasapi32.dll

См. также

RasSetAutodialAddress

RasSetAutodialParam

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

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

Поделиться через