Om DLL:er för RAS-administration

RAS-administrations-DLL exporterar funktioner som RAS-servern anropar när en användare försöker ansluta eller koppla från. Här är några av de möjliga användningsområdena för en RAS-administrations-DLL:

• Bestäm om en användare ska kunna ansluta till servern. Administrations-DLL:en kan tillhandahålla en säkerhetskontroll utöver standardautentiseringen för RAS-användare.
• Registrera den tid då varje användare ansluter till och kopplar från servern. Detta kan vara användbart i fakturerings- eller granskningssyfte.
• Tilldela en IP-adress till varje användare. Detta är användbart för säkerhet eftersom den här funktionen används för att mappa en användares anslutning till en viss dator.

Platsen för RAS-administrations-DLL anges i registret. se DLL-registerinstallation för RAS-administration.

RAS stöder flera administrations-DLL:er. Registret stöder flera DLL-platser. RAS anropar funktionerna i DLL:er i den ordning DLL:er visas i registret. se DLL-registerinstallation för RAS-administration.

Windows 2000 Server: RAS stöder inte flera DLL:er.

En DLL för RAS-administration måste implementera och exportera alla följande funktioner:

MprAdminAcceptNewLink

MprAdminInitializeDll

MprAdminLinkHangupNotification

MprAdminTerminateDll

Dessutom måste RAS-administrationens DLL implementera och exportera antingen

MprAdminAcceptNewConnection och

MprAdminConnectionHangupNotification

eller

MprAdminAcceptNewConnection2 och

MprAdminConnectionHangupNotification2

Om alla nödvändiga funktioner inte implementeras kan RAS inte starta.

Windows 2000 Server: En administrations-DLL måste implementera funktionerna MprAdminGetIpAddressForUser och MprAdminReleaseIpAddress. Om DLL:n implementerar en av dessa funktioner måste den också implementera den andra.

RAS anropar funktionen MprAdminInitializeDll när routnings- och fjärråtkomsttjänsten startas. Funktionen MprAdminInitializeDll ger administrations-DLL:en möjlighet att utföra alla nödvändiga initieringar. På samma sätt anropar RAS MprAdminTerminateDll-tjänsten när routnings- och fjärråtkomsttjänsten stängs av. Med den här funktionen kan administrations-DLL:en utföra nödvändig rensning innan den avslutas.

Funktionerna MprAdminAcceptNewConnection och MprAdminConnectionHangupNotification gör att DLL:en kan granska användaranslutningar till servern. En RAS-server anropar funktionen MprAdminAcceptNewConnection när en användare försöker ansluta. Den här funktionen gör det möjligt att förhindra att användaren ansluter. Funktionen MprAdminAcceptNewConnection kan också generera loggposter för fakturering eller granskning. När användaren kopplar från anropar RAS-servern funktionen MprAdminConnectionHangupNotification, som kan logga tidpunkten för när användaren kopplades från.

Funktionerna MprAdminAcceptNewConnection2 och MprAdminConnectionHangupNotification2 liknar MprAdminAcceptNewConnection och MprAdminConnectionHangupNotification. Men när RAS anropar funktionerna MprAdminAcceptNewConnection2 och MprAdminConnectionHangupNotification2 skickar RAS in ytterligare en parameter av typen RAS_CONNECTION_2.

RAS stöder flera administrations-DLL:er. Fjärråtkomstanvändaren kan endast ansluta om implementeringen av funktionen MprAdminAcceptNewConnection eller MprAdminAcceptNewConnection2 i var och en av DLL:erna accepterar anslutningen. Med andra ord måste varje DLL acceptera anslutningen för att användaren ska kunna ansluta.

Det är möjligt för en enskild RAS-anslutning att använda flera länkar när du ansluter till en RAS-server. Funktionerna MprAdminAcceptNewLink och MprAdminLinkHangupNotification gör det möjligt för administrations-DLL att hantera enskilda länkar i en anslutning. RAS anropar MprAdminAcceptNewLink när en ny länk upprättas för en anslutning. Eftersom alla anslutningar omfattar minst en länk RAS anropar alltid MprAdminAcceptNewLink en gång omedelbart efter MprAdminAcceptNewConnection eller MprAdminAcceptNewConnection2 returnerar, förutsatt att MprAdminAcceptNewConnection eller MprAdminAcceptNewConnection2 accepterat anslutningen. RAS anropar MprAdminLinkHangupNotification när en länk för en anslutning stängs av.

Eftersom RAS stöder flera administrations-DLL:er tillåts fjärråtkomstanvändaren endast ansluta om implementeringen av MprAdminAcceptNewLink funktion i var och en av DLL:erna accepterar anslutningen. Med andra ord måste varje DLL acceptera länken för att länken ska upprättas.

När RAS-servern har autentiserat en användare anropas funktionen MprAdminGetIpAddressForUser för att hämta en IP-adress för fjärrklienten. Den här funktionen tillhandahåller ett alternativt schema för att mappa en IP-adress till en uppringningsanvändare. Om MprAdminGetIpAddressForUser inte implementeras associerar en RAS-server fjärranvändaren med en IP-adress som har valts från en statisk pool med IP-adresser eller en som valts av en DHCP-server (Dynamic Host Configuration Protocol). Funktionen MprAdminGetIpAddressForUser gör att DLL:n kan åsidosätta den här standard-IP-adressen och ange en viss IP-adress för varje användare. Funktionen MprAdminGetIpAddressForUser kan ange en flagga som gör att RAS anropar funktionen MprAdminReleaseIpAddress när användaren kopplas från. DLL:en kan sedan använda MprAdminReleaseIpAddress för att uppdatera användarensto-IP-adressmappning.

RAS stöder flera administrations-DLL:er, men anropar MprAdminGetIpAddressForUser och MprAdminReleaseIpAddress funktioner endast i den första DLL som implementerar och exporterar dem. RAS ignorerar implementeringar av dessa funktioner i de andra DLL:erna. RAS kontrollerar DLL:er för dessa funktioner i den ordning de visas i -registret.

RAS serialiserar anrop till administrations-DLL. Ett anrop till en av DLL-funktionerna för en viss RAS-klient föregriper inte ett anrop till den funktionen för en annan RAS-klient. RAS anropar inte funktionen för den andra klienten förrän det första anropet har slutförts. Dessutom utökas serialiseringen till vissa grupper av funktioner. IP-adressfunktionerna serialiseras som en grupp. ett anrop till antingen MprAdminGetIpAddressForUser eller MprAdminReleaseIpAddress blockerar anrop till båda funktionerna tills det första anropet har returnerats. MprAdminAcceptNewConnection och MprAdminConnectionHangupNotification serialiseras också som en grupp.

RAS kör de funktioner som tilldelar IP-adresser i en process. funktionerna för anslutnings- och frånkopplingsmeddelanden körs i en annan process. DLL-filen är därför inte beroende av delade data mellan dessa två uppsättningar funktioner.

Anropa inte någon av RAS-administrationsfunktioner eller RAS-användaradministrationsfunktioner inifrån en ejektorfunktionsanrop. Anrop till dessa funktioner returneras inte när de utförs inifrån en callout-funktion.

RAS-servern loggar ett fel i systemhändelseloggen om ett fel inträffar när den försöker läsa in en RAS-administrations-DLL eller när någon av DLL-funktionerna anropas. Detta kan till exempel inträffa om DLL angav fel namn för en exporterad funktion, eller om den inte innehöll funktionsnamnet i DEF-filen. Posten i händelseloggen anger orsaken till felet.

Windows 2000/NT: Administrations-DLL-filer stöds inte.