自己做RAS Administration DLL

本文其他部分是MSDN的内容，我自己的心得在这里：

• MprAdminInitializeDll这个函数的原型，VS2003自带的MSDN里，被定义为无返回值(void)，如果按照这个原型去做，会死得很难看。正确的原型是在线MSDN中定义的返回一个DWORD型（NOERROR表示成功）
• MprAdminAcceptNewConnection提供的用户IP，其实是虚网地址，而不是它真正的IP地址，所以，用处不大（无法根据一个IP来判断用户是否合法）。
• 如果想用MprAdminServerConnect取得RAS句柄，不能在MprAdminInitializeDll等函数中调用，因为此时RAS尚未成功启动，会返回RPC_S_UNKNOWN_IF，而在其他事件里调用，好象会造成死锁，所以，我的作法是，在MprAdminInitializeDll里启动一个线程，每秒钟尝试一次，直到成功取得为止。通常我会用QueueUserWorkItem这个API来做这个事情。

RAS是指Remote Access Service，而RAS Administration DLL是指用户自己写的一个动态链接库，它实现了规定的几个函数，由RAS来加载，当有用户连入或断开时，RAS会自动调用这些函数，使得我们可以实现一些附加的需求，比方说可以由自己来决定是否允许一个用户连入，或者在连入和断开的时候记录日志，还可以给用户指定（虚网的）IP：

要让RAS知道我们自己编写的DLL在哪里，必须在注册表中创建名为  HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/RAS/AdminDll 的键，然后在该键下创建两个字符串型的值：

名称	值	示例
DisplayName	自定义显示名称，可以任意指定。	无于声处听惊雷
DLLPath	DLL的路径全名，多个DLL名之间用逗号分开（但Windows 2000 Server是不支持多个DLL的，目前仅2003支持）	c:/foo/bar.dll

DLL中必须至少实现并export下列四个函数，否则RAS启动会失败：

• MprAdminAcceptNewLink
• MprAdminInitializeDll
• MprAdminLinkHangupNotification
• MprAdminTerminateDll

通常，还会实现并export（不然DLL做什么呢？）：

• MprAdminAcceptNewConnection
• MprAdminConnectionHangupNotification

或

• MprAdminAcceptNewConnection2
• MprAdminConnectionHangupNotification2

而在Windows 2000 Server中，DLL还必须实现  MprAdminGetIpAddressForUser 和  MprAdminReleaseIpAddress 这两个函数。