Platform SDK: RAS/Routing and RAS |
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 );
The function does not return a value. There are no extended error information for this function; do not call GetLastError.
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 ProElectron, Inc. might be:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\RAS\AdminDll
DisplayName : REG_SZ : ProElectron 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.
Windows NT/2000: Requires Windows NT 4.0 or later.
Header: Declared in Rassapi.h.
Remote Access Service (RAS) Overview, RAS Server Administration Functions, RAS_PARAMETERS, RAS_PORT_1, RAS_PORT_STATISTICS