На главную

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

Subentries and Multilink Connections



Windows NT version 4.0 provides support for phone-book subentries, which enable multilink connections. A multilink connection combines the bandwidth of multiple connections to provide a single connection with higher bandwidth.

A RAS phone-book entry can have zero or more subentries. The RasGetEntryProperties function retrieves a RASENTRY structure that includes information about the subentries of a phone-book entry. The dwSubEntries member of the RASENTRY structure indicates the number of subentries. Phone-book entries initially have no subentries. To add subentries to a phone-book entry, use the RasSetSubEntryProperties function.

The properties for each subentry include a phone number and the name and type of the TAPI device to use when dialing the subentry. In addition, a subentry can include a list of alternate phone numbers to dial if RAS cannot make a connection using the primary number. The RasSetSubEntryProperties and RasGetSubEntryProperties functions use the RASSUBENTRY structure to set and retrieve the properties of a specified phone-book subentry. Subentries are identified by a one-based index.

You can call the RasSetEntryProperties function to configure a multilink RAS entry to connect all subentries when it is first dialed. Alternatively, you can configure an entry to provide variable bandwidth. In this case, RAS connects a single subentry initially, and then connects or disconnects additional subentries as needed. For a variable-bandwidth multilink connection, you can use the RASDIALPARAMS structure to specify the initial subentry to connect when you call the RasDial function. When using the RasDialDlg function to connect a multilink entry, you can use the RASDIALDLG structure to specify the initial subentry to connect.

For a variable-bandwidth multilink connection, use the RASENTRY structure with the RasSetEntryProperties function to specify the parameters for connecting and disconnecting the individual subentries. RAS connects an additional subentry when the bandwidth being used exceeds a specified percentage of the available bandwidth for a specified interval.
If you call the RasDial function to establish a multilink connection, you can specify a RasDialFunc2 callback function to receive notifications about the connection. RasDialFunc2 is similar to the RasDialFunc1 callback function, except that it provides additional information for a multilink connection, such as the index of the subentry that caused the notification. RAS calls your RasDialFunc2 function when it connects or disconnects a subentry.

You can use an HRASCONN connection handle to hang up or retrieve information about a multilink connection. You can get a connection handle for each of the subentry connections that make up the multilink, as well as for the combined multilink connection. When you call the RasDial function to establish a multilink connection, RasDial returns a handle to the combined multilink connection. Similarly, RasEnumConnections returns the combined multilink handle when you enumerate connections. To get a handle to one of the subentry connections in a multilink connection, call the RasGetSubEntryHandle function.

You can use the combined multilink connection handle and the subentry connection handles in the RasHangUp, RasGetConnectStatus, and RasGetProjectionInfo functions. Calling RasHangUp with a combined multilink handle terminates the entire connection; calling it with a subentry handle hangs up only that subentry connection. Similarly, RasGetConnectStatus returns information for the combined or individual connection, depending on the handle specified. The projection information returned by RasGetProjectionInfo for a multilink entry is the same for each of the subentry connection handles as it is for the main connection handle.


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

Подстатьи и Связи Multilink



Версия Окна NT 4.0 обеспечивает поддержку для телефонных-книжных подстатей, какие допустимые multilink связи. Связь multilink объединяет ширину полосы частот многочисленных связей, чтобы обеспечивать единственную связь более высокой шириной полосы частот.

RAS Телефонный-книжный вход может иметь нуль или больше подстатьи. Функция RasGetEntryProperties извлекает структуру RASENTRY, которая включает информацию о подстатьях телефонного-книжного входа. Элемент dwSubEntries структуры RASENTRY указывает количество подстатей. Телефонные-книжные данные первоначально не имеют подстатьи. Для того, чтобы добавлять подстатьи к телефонному-книжному входу, используйте функцию RasSetSubEntryProperties.

Свойства для каждой подстатьи включают номер телефона и имя и тип устройства TAPI, чтобы использоваться при кодовом вызове подстатью. Кроме того, подстатья может включить список альтернативных номеров телефона, чтобы набираться если RAS не может сделать связью, использовавшей первичное число. RasSetSubEntryProperties И использование функций RasGetSubEntryProperties структура RASSUBENTRY, чтобы устанавливать и извлекать свойства определенной телефонной-книжной подстатьи. Подстатьи называются один-основавшее индекс.

Вы можете назвать функцию RasSetEntryProperties, чтобы конфигурировать multilink вход RAS, чтобы соединять все подстатьи когда она сначала набрана. Кроме того, Вы можете сконфигурировать вход, чтобы обеспечивать переменную ширину полосы частот. В этом случае, RAS соединяет единственную подстатью первоначально, затем соединяет или разъединяет дополнительные подстатьи как и требуется. Для переменной-ширины полосы частот multilink связь, Вы можете использовать структуру RASDIALPARAMS, чтобы определять начальную подстатью, чтобы соединяться когда Вы называете функцию RasDial. При использовании функции RasDialDlg, чтобы соединять вход multilink, Вы можете использовать структуру RASDIALDLG, чтобы определять начальную подстатью, чтобы соединяться.

Для переменной-ширины полосы частот multilink связь, используйте структуру RASENTRY с функцией RasSetEntryProperties, чтобы определять параметрам для соединения и отключения индивидуальных подстатей. RAS СОЕДИНЯЕТ дополнительную подстатью когда ширина полосы частот, использованная превышает определенный процент доступной ширины полосы частот для определенного интервала.
Если Вы называете функцию RasDial, чтобы устанавливать связь multilink, Вы можете определить функцию возврата RasDialFunc2, чтобы получать уведомления о связи. RasDialFunc2 подобный функции возврата RasDialFunc1, за исключением того это это обеспечивает дополнительную информацию для связи multilink, как например, индекс подстатьи, которая вызывала уведомление. RAS НАЗЫВАЕТ вашу функцию RasDialFunc2 когда это соединяет или разъединяет подстатью.

Вы можете использовать ручку связи HRASCONN, чтобы отключать или извлекать информацию о связи multilink. Вы можете получить ручку связи для каждых связей подстатьи, которые создают multilink, а также для комбинированной multilink связи. Когда Вы называете функцию RasDial, чтобы устанавливать связь multilink, RasDial возвращает ручку на комбинированную multilink связь. Аналогично, RasEnumConnections возвращает комбинированную multilink ручку когда Вы перечисляете связи. Для того, чтобы получать ручку на одну из связей подстатьи на связи multilink, назовите функцию RasGetSubEntryHandle.

Вы можете использовать комбинированную multilink ручку связи и связь подстатьи оперируется в RasHangUp, RasGetConnectStatus, и функциях RasGetProjectionInfo. Вызов RasHangUp с комбинированной multilink ручкой завершает целую связь; вызов это с ручкой подстатьи отключает только эту связь подстатьи. Аналогично, RasGetConnectStatus возвращает информацию для комбинированной или индивидуальной связи, в зависимости от ручки определенной. Информация прогноза возвращанная RasGetProjectionInfo для входа multilink - та же для каждых ручек связи подстатьи как это - для основной ручки связи.


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