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

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

Синтаксис

RASDIALFUNC1 Rasdialfunc1;

void Rasdialfunc1(
  HRASCONN unnamedParam1,
  UINT unnamedParam2,
  tagRASCONNSTATE unnamedParam3,
  DWORD unnamedParam4,
  DWORD unnamedParam5
)
{...}

Параметры

unnamedParam1

unnamedParam2

unnamedParam3

unnamedParam4

unnamedParam5

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

None

Remarks

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

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

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

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

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

Требования

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

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

RASCONNSTATE

Rasdial

RasDialFunc

RasDialFunc2

RasEnumConnections

RasEnumEntries

RasGetConnectStatus

RasGetErrorString

RasHangUp

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

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