На главную

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 | Скачать Вниз

RASCONNSTATE



The RASCONNSTATE enumeration type contains values that specify the states that may occur during a RAS connection operation. If you use the RasDial function to establish a RAS connection, you can specify a window, or a RasDialFunc, RasDialFunc1, or RasDialFunc2 callback function to receive notification messages that report the current connection state. You can also use the RasGetConnectStatus function to get the connection state for a specified connection.

typedef enum _RASCONNSTATE {
RASCS_OpenPort = 0,
RASCS_PortOpened,
RASCS_ConnectDevice,
RASCS_DeviceConnected,
RASCS_AllDevicesConnected,
RASCS_Authenticate,
RASCS_AuthNotify,
RASCS_AuthRetry,
RASCS_AuthCallback,
RASCS_AuthChangePassword,
RASCS_AuthProject,
RASCS_AuthLinkSpeed,
RASCS_AuthAck,
RASCS_ReAuthenticate,
RASCS_Authenticated,
RASCS_PrepareForCallback,
RASCS_WaitForModemReset,

RASCS_WaitForCallback,
RASCS_Projected,

#if (WINVER >= 0x400)
RASCS_StartAuthentication, // Windows 95 only
RASCS_CallbackComplete, // Windows 95 only
RASCS_LogonNetwork, // Windows 95 only
#endif
RASCS_SubEntryConnected,
RASCS_SubEntryDisconnected,

RASCS_Interactive = RASCS_PAUSED,
RASCS_RetryAuthentication,
RASCS_CallbackSetByCaller,
RASCS_PasswordExpired,

RASCS_Connected = RASCS_DONE,

RASCS_Disconnected
} RASCONNSTATE ;


The enumerator values are listed here in the general order in which the connection states occur. However, you should not write code that depends on the order or occurrence of particular RASCONNSTATE connection states, because this may vary between platforms.

Enumerator Meaning
RASCS_OpenPort The communication port is about to be opened.
RASCS_PortOpened The communication port has been opened successfully.
RASCS_ConnectDevice A device is about to be connected. RasGetConnectStatus can be called to determine the name and type of the device being connected.
RASCS_DeviceConnected A device has connected successfully. RasGetConnectStatus can be called to determine the name and type of the device being connected.
For a simple modem connection, RASCS_ConnectDevice and RASCS_DeviceConnected will be called only once. For a dial-up X.25 PAD connection, the pair will be called first for the modem, then for the PAD. If a preconnect switch is configured, the pair will be called for the switch before any other devices connect. Likewise, the pair will be called for a postconnect switch after any other devices connect.Windows 95: Note that Windows 95 does not currently support multistage connections such as the X.25 PAD connection described earlier.
RASCS_AllDevicesConnected All devices in the device chain have successfully connected. At this point, the physical link is established.
RASCS_Authenticate The authentication process is starting. Remote access does not allow the remote client to generate any traffic on the LAN until authentication has been successfully completed. Remote access authentication on a Windows NT or Windows 95 server consists of:· Validating the user name/ password on the specified domain. · Projecting the client onto the LAN. This means that the remote access server does what is necessary to send and receive data on the LAN on behalf of the client. For example, the remote access server might need to add a NetBIOS name that corresponds to the client's computer name. · Call-back processing in which the client hangs up and the server calls back. (The user needs special permissions on the remote access server for this.) · Calculating the link speed. This is necessary to correctly set transport time-outs to match the relatively slow speed of the remote link.
RASCS_AuthNotify An authentication event has occurred. If dwError is zero, this event will be immediately followed by one of the more specific authentication states following. If dwError is nonzero, authentication has failed, and the error value indicates why.
RASCS_AuthRetry The client has requested another validation attempt with a new user name/password/domain. This state does not occur in Windows NT version 3.1.
RASCS_AuthCallback The remote access server has requested a callback number. This occurs only if the user has "Set By Caller" callback privilege on the server.
RASCS_AuthChangePassword The client has requested to change the password on the account. This state does not occur in Windows NT version 3.1.
RASCS_AuthProject The projection phase is starting.
RASCS_AuthLinkSpeed The link-speed calculation phase is starting.
RASCS_AuthAck An authentication request is being acknowledged.
RASCS_ReAuthenticate Reauthentication (after callback) is starting.
RASCS_Authenticated The client has successfully completed authentication.
RASCS_PrepareForCallback The line is about to disconnect in preparation for callback.
RASCS_WaitForModemReset The client is delaying in order to give the modem time to reset itself in preparation for callback.
RASCS_WaitForCallback The client is waiting for an incoming call from the remote access server.
RASCS_Projected This state occurs after the RASCS_AuthProject state. It indicates that projection result information is available. You can access the projection result information by calling RasGetProjectionInfo.
RASCS_StartAuthentication Windows 95 only: Indicates that user authentication is being initiated or retried.
RASCS_CallbackComplete Windows 95 only: Indicates that the client has been called back and is about to resume authentication.
RASCS_LogonNetwork Windows 95 only: Indicates that the client is logging on to the network.
RASCS_SubEntryConnected When dialing a multilink phone-book entry, this state indicates that a subentry has been connected during the dialing process. The dwSubEntry parameter of a RasDialFunc2 callback function indicates the index of the subentry. When the final state of all subentries in the phone-book entry has been determined, the connection state is RASCS_Connected if one or more subentries have been connected successfully.
RASCS_SubEntryDisconnected When dialing a multilink phone-book entry, this state indicates that a subentry has been disconnected during the dialing process. The dwSubEntry parameter of a RasDialFunc2 callback function indicates the index of the subentry.
RASCS_Interactive This state corresponds to the terminal state supported by RASPHONE.EXE. This state does not occur in Windows NT version 3.1.
RASCS_RetryAuthentication This state corresponds to the retry authentication state supported by RASPHONE.EXE. This state does not occur in Windows NT version 3.1.
RASCS_CallbackSetByCaller This state corresponds to the callback state supported by RASPHONE.EXE. This state does not occur in Windows NT version 3.1.
RASCS_PasswordExpired This state corresponds to the change password state supported by RASPHONE.EXE. This state does not occur in Windows NT version 3.1.
RASCS_Connected Successful connection.
RASCS_Disconnected Disconnection or failed connection.


Remarks

The connection process states are divided into three classes: running states, paused states, and terminal states.
An application can easily determine the class of a specific state by performing Boolean bit operations with the RASCS_PAUSED and RASCS_DONE bitmasks. Here are some examples:

fDoneState = (state & RASCS_DONE);
fPausedState = (state & RASCS_PAUSED);
fRunState = !(fDoneState || fPausedState);


See Also

RasDial, RasGetConnectStatus, RasGetProjectionInfo, RASCONNSTATUS


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

RASCONNSTATE



Тип перечисления RASCONNSTATE содержит величины, которые определяют указывается, что может произойти в течение действия связи RAS. Если Вы используете функцию RasDial, чтобы устанавливать связь RAS, Вы можете определить окно, или RasDialFunc, RasDialFunc1, или функция возврата RasDialFunc2, чтобы получать сообщения уведомления, которые сообщают текущее состояние связи. Вы можете также использовать функцию RasGetConnectStatus, чтобы получать состояние связи для определенной связи.

typedef enum _RASCONNSTATE { RASCS_OpenPort = 0, RASCS_PortOpened, RASCS_ConnectDevice, RASCS_DeviceConnected, RASCS_AllDevicesConnected, RASCS_Authenticate, RASCS_AuthNotify, RASCS_AuthRetry, RASCS_AuthCallback, RASCS_AuthChangePassword, RASCS_AuthProject, RASCS_AuthLinkSpeed, RASCS_AuthAck, RASCS_ReAuthenticate, RASCS_Authenticated, RASCS_PrepareForCallback, RASCS_WaitForModemReset,

RASCS_WaitForCallback, RASCS_Projected,

#if (WINVER >= 0x400)
RASCS_StartAuthentication, // Окно 95 только RASCS_CallbackComplete, // Окно 95 только RASCS_LogonNetwork, // Окно 95 только #endif
RASCS_SubEntryConnected, RASCS_SubEntryDisconnected,

RASCS_Interactive = RASCS_PAUSED, RASCS_RetryAuthentication, RASCS_CallbackSetByCaller, RASCS_PasswordExpired,

RASCS_Connected = RASCS_DONE,

RASCS_Disconnected } RASCONNSTATE;


Величины списка указываются здесь в общем порядке в котором состояния связи происходят. Тем не менее, вам не следует написать код, который зависит от порядка или случая конкретных состояний связи RASCONNSTATE, поскольку это может измениться между платформами.

Значение Списка
RASCS_OpenPort коммуникационный порт собирается быть открыт.
RASCS_PortOpened коммуникационный порт открывается успешно.
RASCS_ConnectDevice устройство собирается быть связано. RasGetConnectStatus МОЖЕТ быть вызван, чтобы определять имя и тип устройства, связыванные.
RASCS_DeviceConnected устройство связалось успешно. RasGetConnectStatus МОЖЕТ быть вызван, чтобы определять имя и тип устройства, связыванные.
Для простой связи модема, RASCS_ConnectDevice и RASCS_DeviceConnected вызовется только как только. Для наборной связи ПАНЕЛИ X.25, пара будет вызвана сначала для модема, затем для ПАНЕЛИ. Если ключ preconnect сконфигурирован, пара будет вызвана к ключу прежде, чем любые другие устройства соединятся. Подобно, пара будет вызвана к ключу postconnect после того, как любые другие устройства соединятся.Окно 95: Отметьте, что Окно 95 к настоящему времени не поддерживает многоступенчатые связи как например, связь ПАНЕЛИ X.25 описывалась раньше.
RASCS_AllDevicesConnected Всех устройств в цепи устройства успешно связались. В этой точке, физическая связь установлена.
RASCS_Authenticate процесс аутентификации начинается. Дистанционный доступ не позволяет дистанционного клиента, чтобы генерировать любое движение на LAN пока аутентификация успешно не завершена. Дистанционная аутентификация доступа в Windows NT или сервере Windows 95 состоит из: Подтверждая имя/ пароль пользователя на определенном domain. Планируя клиента на LAN. Это означает, что дистанционный сервер доступа делает что необходим посылать и получать данные о LAN от имени клиента. Например, дистанционный сервер доступа вероятно нужно добавлять имя NetBIOS, которое переписывается в компьютер клиента name. Вызов-обрабатывая в котором клиент отключает и сервер вызывается. ( Пользователю нужно специальные разрешения в дистанционном сервере доступа для this.) Вычисляя скорость связи. Необходимо правильно установившее задержки транспорта, чтобы соответствовать сравнительно низкоскоростному дистанционной связи.
RASCS_AuthNotify событие аутентификации произошло. Если dwError является нулем, это событие немедленно будет сопровождено одним из более следующего состояний специфической аутентификации. Если dwError ненулевой, аутентификация потерпела неудачу, и величина ошибки указывается почему.
RASCS_AuthRetry клиент запросил другую попытку подтверждения с новым именем/паролем пользователя/области. Это состояние не происходит в версии Windows NT 3.1.
RASCS_AuthCallback дистанционный сервер доступа запросил номер возврата. Это происходит только если пользователь привилегии возврата "Установился бы Вызывающим оператором" в сервере.
RASCS_AuthChangePassword клиент запросился, чтобы изменять пароль на счете. Это состояние не происходит в версии Windows NT 3.1.
RASCS_AuthProject фаза прогноза запускается.
RASCS_AuthLinkSpeed вычисление связи-скорость фазы запускается.
RASCS_AuthAck запрос аутентификации признается.
RASCS_ReAuthenticate Reauthentication (после возврата), запускается.
RASCS_Authenticated клиент успешно завершил аутентификацию.
RASCS_PrepareForCallback линия собирается разъединяться на подготовке для возврата.
RASCS_WaitForModemReset клиент задерживает для того, чтобы давать время модема, чтобы восстанавливать себя на подготовке для возврата.
RASCS_WaitForCallback клиент ждет поступающий вызов из дистанционного сервера доступа.
RASCS_Projected Этого состояния происходит после состояние RASCS_AuthProject. Это указывает, что информация результата прогноза доступна. Вы можете иметь доступ к информации результата прогноза вызывая RasGetProjectionInfo.
RASCS_StartAuthentication Windows 95 только: Указывает, что аутентификация пользователя вводится или делает новую попытку.
RASCS_CallbackComplete Windows 95 только: Указывает, что клиент вызван и собрался продолжать аутентификацию.
RASCS_LogonNetwork Windows 95 только: Указывает, что клиент регистрируется в сети.
RASCS_SubEntryConnected При кодовом вызове multilink телефонный-книжный вход, это состояние указывает, что подстатья связана в течение процесса кодового вызова. Параметр dwSubEntry функции возврата RasDialFunc2 указывает индекс подстатьи. Когда конечное состояние всех подстатей на телефонном-книжном входе определено, состояние связи - RASCS_Connected если одна или более подстатей связываются успешно.
RASCS_SubEntryDisconnected При кодовом вызове multilink телефонный-книжный вход, это состояние указывает, что подстатья разъединена в течение процесса кодового вызова. Параметр dwSubEntry функции возврата RasDialFunc2 указывает индекс подстатьи.
RASCS_Interactive Этого состояния переписывается в терминальное состояние поддерживанное RASPHONE.EXE. Это состояние не происходит в версии Windows NT 3.1.
RASCS_RetryAuthentication Этого состояния переписывается в состояние аутентификации повторной попытки поддерживанное RASPHONE.EXE. Это состояние не происходит в версии Windows NT 3.1.
RASCS_CallbackSetByCaller Этого состояния переписывается в состояние возврата поддерживанное RASPHONE.EXE. Это состояние не происходит в версии Windows NT 3.1.
RASCS_PasswordExpired Этого состояния переписывается в состояние пароля изменения поддерживанное RASPHONE.EXE. Это состояние не происходит в версии Windows NT 3.1.
Успешная связь RASCS_Connected.
Разъединение RASCS_Disconnected или неудачная связь.


Замечания

Состояния процесса связи подразделены на три класса: прогон состояний, остановившихся состояния, и терминальные состояния.
Приложение может легко определить класс специфического состояния выполняя Логические битовые операции с RASCS_PAUSED и bitmasks RASCS_DONE. Вот некоторые примеры:

fDoneState = (СОСТОЯНИЕ & RASCS_DONE);
fPausedState = (СОСТОЯНИЕ & RASCS_PAUSED);
fRunState = !(fDoneState || fPausedState);


Смотри Также

RasDial, RasGetConnectStatus, RasGetProjectionInfo, RASCONNSTATUS


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz