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

Статья
03/01/2024

Функция обратного вызова RasDialFunc вызывается функцией RasDial при изменении состояния во время процесса подключения RAS.

Синтаксис

RASDIALFUNC Rasdialfunc;

void Rasdialfunc(
  UINT unnamedParam1,
  tagRASCONNSTATE unnamedParam2,
  DWORD unnamedParam3
)
{...}

Параметры

unnamedParam1

unnamedParam2

unnamedParam3

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

None

Remarks

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

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

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

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

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

Требования

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