На главную

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

RasAdminConnectionHangupNotification



[New - Windows NT]

The RasAdminConnectionHangupNotification function is an application-defined function that is exported by a third-party RAS server administration DLL. When RAS disconnects an existing connection, it calls this function to notify your DLL.
The RAS server calls RasAdminConnectionHangupNotification once for each port in a multilink connection.

VOID RasAdminConnectionHangupNotification(

RAS_PORT_1 *pRasPort1, // pointer to information about the connection
RAS_PORT_STATISTICS *pRasStats, // pointer to statistics about the port
RAS_PARAMETERS *pRasParams // pointer to an array of media-specific parameters and values
);


Parameters

pRasPort1

Pointer to a RAS_PORT_1 structure that contains RAS data about the connection that ended. This structure contains the relevant connection information that you can use to determine how long the port was connected.

pRasStats

Pointer to a RAS_PORT_STATISTICS structure that contains statistics about the port. RAS began accumulating these statistics when the connection was first established.

pRasParams

Pointer to an array of RAS_PARAMETERS structures. Each structure contains the name of a media-specific key, such as MAXCONNECTBPS, and its associated value.



Return Values

The function does not return a value.

Remarks

The RAS call to the RasAdminConnectionHangupNotification function is just a notification; no action is required from your DLL. You can use the information provided by this function for accounting purposes.
The setup program for a third-party RAS administration DLL must register the DLL with RAS by providing information under the following key in the registry:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RAS\AdminDll


To register the DLL, set the following values under this key.

Value Name Value Data
DisplayName A REG_SZ string that contains the user-friendly display name of the DLL.
DLLPath A REG_SZ string that contains the full path of the DLL.


For example, the registry entry for a RAS Administration DLL from a fictional company named Netwerks Corporation might be:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RAS\AdminDll
DisplayName : REG_SZ : Netwerks RAS Admin DLL
DLLPath : REG_SZ : C:\nt\system32\ntwkadm.dll


The setup program for a RAS Administration DLL should also provide remove/uninstall functionality. If a user removes the DLL, the setup program should delete the DLL's registry entries.

See Also

RAS_PARAMETERS, RAS_PORT_1, RAS_PORT_STATISTICS


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

RasAdminConnectionHangupNotification



[Новый - Windows NT]

Функция RasAdminConnectionHangupNotification является определенной прикладной функцией, которая экспортирована независимой администрацией сервера RAS DLL. Когда RAS разъединяет существующую связь, это называет эту функцию, чтобы уведомлять ваше DLL.
Сервер RAS называет RasAdminConnectionHangupNotification как только для каждого порта на связи multilink.

ПУСТОТА RasAdminConnectionHangupNotification(

RAS_PORT_1 *pRasPort1, // указатель в информацию о связи RAS_PORT_STATISTICS *pRasStats, // указатель в статистику о порту RAS_PARAMETERS *указатель pRasParams // в массив носитель-специфических параметров и величин
);


Параметры

pRasPort1

Указатель в структуру RAS_PORT_1, которая содержит данные RAS о связи, что заканчивался. Эта структура содержит важную информацию связи, которую Вы можете использовать, чтобы определять сколько порт был связан.

pRasStats

Указатель в структуру RAS_PORT_STATISTICS, которая содержит статистику о порту. RAS НАЧАЛ накапливать эту статистику когда связь сначала была установлена.

pRasParams

Указатель в массив структур RAS_PARAMETERS. Каждая структура содержит имя носитель-специфической клавиши, как например, MAXCONNECTBPS, и связанная величина.



Обратные Величины

Функция не возвращает величину.

Замечания

Вызов RAS в функцию RasAdminConnectionHangupNotification - просто уведомление; никакое действие не потребовалось из вашего DLL. Вы можете использовать информацию предусмотренную этой функцией за счет целей.
Программа установки для независимой администрации RAS DLL должна зарегистрировать DLL с RAS обеспечивая информацию под следующей клавишей в регистрации:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RAS\AdminDll


Для того, чтобы регистрировать DLL, установите следующее величин под этой клавишей.

Данные Величины Имени Величины
DisplayName СТРОКА REG_SZ, что содержит дружественное дисплейное имя DLL.
DLLPath СТРОКА REG_SZ, что содержит полный путь DLL.


Например, вход регистрации для RAS Administration DLL из фиктивной компании назвавшей Корпорацию Netwerks могло быть:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RAS\AdminDll DisplayName : REG_SZ : Netwerks RAS Admin DLL DLLPath : REG_SZ : C:\nt\system32\ntwkadm.dll


Программа установки для RAS Administration DLL должна также обеспечить удаление/модифицировать функциональное назначение. Если пользователь удаляет DLL, программа установки должна удалить данные регистрации DLL's.

Смотри Также

RAS_PARAMETERS, RAS_PORT_1, RAS_PORT_STATISTICS


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