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

Статья
03/05/2024

Функция обратного вызова RasDialFunc2 вызывается вызовом функции RasDial при изменении состояния во время подключения удаленного доступа. Функция RasDialFunc2 аналогична функции обратного вызова RasDialFunc1 , за исключением того, что она предоставляет дополнительные сведения о многолинковых подключениях.

Синтаксис

RASDIALFUNC2 Rasdialfunc2;

DWORD Rasdialfunc2(
  ULONG_PTR unnamedParam1,
  DWORD unnamedParam2,
  HRASCONN unnamedParam3,
  UINT unnamedParam4,
  tagRASCONNSTATE unnamedParam5,
  DWORD unnamedParam6,
  DWORD unnamedParam7
)
{...}

Параметры

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

unnamedParam6

unnamedParam7

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

Если функция RasDialFunc2 возвращает ненулевое значение, RasDial продолжает отправлять уведомления обратного вызова.

Если функция RasDialFunc2 возвращает ноль, RasDial прекращает отправку уведомлений обратного вызова для всех вложенных узлов.

Операция подключения RasDial приостанавливается во время вызова функции обратного вызова RasDialFunc2 . По этой причине реализация RasDialFunc2 обычно возвращается как можно быстрее. Существует два исключения из этого правила. Асинхронные (медленные) устройства, такие как модемы, часто имеют периоды ожидания, измеряемые в секундах, а не в миллисекундах; Медленный возврат функции RasDialFunc2 обычно не является проблемой. Требование возврата запроса также не применяется, если параметр dwError не равен нулю, что указывает на то, что произошла ошибка. Например, можно создать диалоговое окно с ошибкой и дождаться ввода данных пользователем.

Реализация RasDialFunc2 не должна зависеть от порядка или вхождения определенных состояний соединения RASCONNSTATE , так как это может отличаться на разных платформах.

Не вызывайте функцию RasDial из функции обратного вызова RasDialFunc2 . Вызовите функции RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString и RasHangUp из функции обратного вызова. Например, вызов RasGetConnectStatus из функции обратного вызова будет полезен для определения имени и типа подключающегося устройства.

Примечание Для удобства RasHangUp можно вызывать из функции обратного вызова RasDialFunc2 . Однако большая часть обработки зависания происходит после возврата функции обратного вызова RasDialFunc2 .

Примечание. RasDialFunc2 — это заполнитель для имени определяемой приложением или библиотекой функции.

Требования

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