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

Статья
08/25/2023

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

Этот прототип предоставляется для обеспечения совместимости с более ранними версиями Windows. Новые приложения должны использовать функцию обратного вызова RASADFunc . Поддержка этого прототипа может быть удалена в будущих версиях RAS.

Синтаксис

ORASADFUNC Orasadfunc;

BOOL Orasadfunc(
  HWND unnamedParam1,
  LPSTR unnamedParam2,
  DWORD unnamedParam3,
  LPDWORD unnamedParam4
)
{...}

Параметры

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

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

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

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

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

Чтобы включить обработчик ORASADFunc для записи телефонной книги, используйте структуру RASENTRY в вызове функции RasSetEntryProperties . Член szAutodialDll указывает имя библиотеки DLL, содержащей обработчик, а член szAutodialDll — экспортированное имя обработчика.

Функция ORASADFunc является заполнителем для имени функции, определяемой библиотекой. Тип ORASADFUNC является указателем на функцию ORASADFunc .

Требования

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