On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

Notification Handlers

An asynchronous RasDial call must specify a notification handler. During an asynchronous connection operation, the Remote Access Connection Manager uses the notification handler to inform the RAS client whenever the connection state changes or an error occurs.

The actions performed by a notification handler can be divided into the following categories:

· Handling errors_win32_Handling_RAS_errors.
· Providing feedback to the user as the connection operation proceeds through the various connection states. See Informational Notifications.
· Handling paused states.
· Signaling the RAS client application when the connection operation has been completed. See Completion Notifications.

There are three types of notification handlers, each of which receives the same basic information: the current connection state and an error code that is nonzero only if an error has occurred.

RasDialFunc A callback function prototype that receives only the current connection state and error code information.
RasDialFunc1 A callback function prototype that receives the HRASCONN connection handle and extended error information in addition to the basic information. The connection handle parameter makes RasDialFunc1 useful for client applications that support multiple simultaneous connection operations. This allows the client to specify the same callback function for all operations, and enables the callback function to determine which connection is changing states.
Window handle A window handle to which RAS sends WM_RASDIALEVENT messages containing the current connection state and error code information. Use this method if your source code must be compatible with 16-bit Windows, because 16-bit Windows does not support either of the callback functions.

The Remote Access Connection Manager suspends the connection operation until the notification handler returns. For this reason, the handler should return as soon as possible unless an error has occurred.
The RasDial function should not be called from within a notification handler. The other remote access functions (RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString, and RasHangUp) can be called from within a handler.

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Вручители Уведомления

Асинхронный вызов RasDial должен определить вручителя уведомления. В течение асинхронного действия связи, Менеджер Связи Дистанционного Доступа использует вручителя уведомления, чтобы сообщать клиента RAS всякий раз, когда состояние связи изменяется или ошибка происходит.

Действия выполненные вручителем уведомления могут быть подразделены на следующие категории:

Обрабатывая errors_win32_Handling_RAS_errors.
Обеспечивая обратную связь потребителю так как действие связи приступает через различные состояния связи. Смотри Информационные Уведомления.
Обрабатывая остановленные состояния.
Сигнализируя приложение клиента RAS когда действие связи завершено. Смотри Уведомления Завершения.

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

RasDialFunc ФУНКЦИОНАЛЬНЫЙ прототип возврата, который получает только текущую связь государственная и кодовая информация ошибки.
RasDialFunc1 функциональный прототип возврата, который получает ручку связи HRASCONN и расширившую информацию ошибки дополнительно к основной информации. Параметр ручки связи делает RasDialFunc1 полезным для приложений клиента, которые поддерживают многочисленные одновременные операции связи. Это позволяет клиента, чтобы определять ту же функцию возврата для всех операций и позволять функцию возврата, чтобы определять, что какая связь изменяет состояния.
Окно оперирует ручку окна на которую RAS посылает сообщения WM_RASDIALEVENT, содержащие текущую связь государственная и кодовая информация ошибки. Используйте этот метод если ваш исходный код должен быть совместимым с 16- битом Windows, поскольку 16- бит Windows не поддерживает любую из функций возврата.

Менеджер Связи Дистанционного Доступа задерживает операцию связи пока вручитель уведомления не возвращается. По этой причине, вручитель должен возвращаться как можно скорее если ошибка не произошла.
Функция RasDial не должна вызывана из вручителя уведомления. Другой дистанционный доступ функционирует (RasGetConnectStatus, RasEnumEntries, RasEnumConnections, RasGetErrorString, и RasHangUp), может быть вызвано из вручителя.

Используются технологии uCoz