windows-server-2003/net/rras/ip/sample

This code provides a sample implementation of an IP routing protocol.  It

illustrates the interaction with the IP Router Manager and the Route Table

Manager (v2).  It also provides guidelines for efficient use of the event

logging and tracing facilities provided with the Routing SDK. The code uses

WinSock2 functionality for optimized execution.  It also contains comments

about the preferred usage of NT and Routing functionalities (such as worker

threads, etc).



To run the sample, you need to build the LoadProtocol sample, which will load

this sample protocol. Please see ..\LoadProtocol for more info.



The sample protocol DLL (ipsample.dll) needs to be copied to the 

%SytemRoot%system32 folder



The sample protocol should be registered in the following registry

location (invoke ipsample.reg to effect these changes):





\HKEY_LOCAL_MACHINE

 \Software

  \Microsoft

   \Router

    \CurrentVersion

     \RouterManagers

      \IP

       \IPSAMPLE

        VendorName      = Microsoft (Value Type: REG_SZ)

        Title           = Sample IP Routing Protocol (Value Type: REG_SZ)

        ProtocolId      = 0x00c8 (Value Type:REG_DWORD)

        Flags           = 0  (Value Type:REG_DWORD)

        DLLName         = IPSAMPLE.DLL (Value Type: REG_SZ)

        ConfigDLL       = admin application dll (Value Type: REG_EXPAND_SZ)

        ConfigClsid     = admin application CLSID (Value Type: REG_SZ)





DESCRIPTION



Once the sample protocol is installed, it will periodically send out hello

messages on every active (enabled and bound) interface.  These are received

by all routers on the subnet running the sample protocol.  The MIB api

allows one to get and set the global and interface specific configuration

and to obtain the interface bindings as well as the global and interface

statistics.  These structures are defined in <ipsamplerm.h>...





CAVEAT



At this moment the sample does not support unnumbered interfaces.  This

feature will be demonstrated in a future release.





FILES



README          this file



makefile        unchanged

makefile.inc    build instructions for resources

makefile.sdk    build instructions for external distribution

sources         compilation instructions for sample.dll and sampletest.exe



ipsample.def    functions and variables exported by sample.dll



list.h

hashtable.[ch]

sync.h

utils.[ch]

packet.[ch]

socket.[ch]

networkentry.[ch]

networkmgr.[ch]

configentry.[ch]

configmgr.[ch]

mibmgr.[ch]

rtmapi.[ch]

rmapi.[ch]

test.c



log.h           localizable error codes

ipsample.rc     dll resources file

ipsample.[ch]   dll main file



pchsample.h     precompiled header



sampletest.rc   test resources file

sampletest.h    test header file

sampletest.cxx  test main file (cxx extention precludes pch inclusion)