Функция обратного вызова RASADFUNCA (ras.h)

  • Статья

Функция RASADFunc — это определяемая приложением функция обратного вызова, которая используется для предоставления настраиваемого пользовательского интерфейса для автодиалинга.

Синтаксис

RASADFUNCA Rasadfunca;

BOOL Rasadfunca(
  LPSTR unnamedParam1,
  LPSTR unnamedParam2,
  LPRASADPARAMS unnamedParam3,
  LPDWORD unnamedParam4
)
{...}

Параметры

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

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

Если приложение выполняет операцию набора номера, возвращается значение TRUE. Используйте параметр lpdwRetCode , чтобы указать результаты операции набора номера.

Если приложение не выполняет операцию набора номера, возвращается значение FALSE. В этом случае система использует пользовательский интерфейс по умолчанию для набора номера.

Комментарии

Когда система запускает операцию автодиализации для записи телефонной книги с пользовательским обработчиком autoDial, она вызывает указанный RASADFunc. RASADFunc может запустить поток для выполнения операции настраиваемого набора. Функция RASADFunc возвращает значение TRUE , чтобы указать, что она взяла на себя набор, или FALSE , чтобы разрешить системе выполнить набор.

Если функция RASADFunc выполняет операцию набора, она предоставляет собственный пользовательский интерфейс для набора и вызывает функцию RasDial для выполнения фактического набора. Затем RASADFunc возвращает значение TRUE , чтобы указать, что он взял на себя набор. После завершения операции набора номера задайте переменную, на которую указывает параметр lpdwRetCode , чтобы указать успешное или неудачное завершение.

Библиотека DLL autoDial должна предоставлять версию обработчика RASADFUNCA (ANSI) и RASADFUNCW (Юникод). Чтобы включить обработчик autoDial RASADFunc для записи телефонной книги, используйте структуру RASENTRY в вызове функции RasSetEntryProperties . Член szAutodialDll указывает имя библиотеки DLL, содержащей обработчик, а член szAutodialFunc указывает экспортированное имя обработчика. Член szAutodialFunc не должен содержать суффикс "A" или "W".

RASADFunc — это заполнитель для имени функции, определяемой библиотекой. Тип RASADFUNC является указателем на функцию RASADFunc .

Примечание

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

Требования

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

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

RASENTRY

Rasdial

RasSetEntryProperties

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

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