функция обратного вызова 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 |