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

Статья
11/20/2024

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

Синтаксис

RASADFUNCA Rasadfunca;

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

Параметры

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

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

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

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

Замечания

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

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

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

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

Заметка

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

Требования

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

См. также

RASENTRY

RasDial

RasSetEntryProperties

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

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

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