home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / netds / rpc / rpcsvc / readme.txt < prev    next >
Text File  |  1996-01-17  |  3KB  |  87 lines
  1. RPCSVC
  2.  
  3.  
  4. The RPCSVC program demonstrates how to implement an NT system service that 
  5. uses RPC.
  6.  
  7. SUMMARY
  8. =======
  9.  
  10. This particular RPC service is designed to show the performance effects of 
  11. various parameters to RPC APIs and interface design.
  12.  
  13. The service can be started and stopped from either the Services control 
  14. panel, the net start/stop command line, or by using the Service Controller 
  15. utility (see below).
  16.  
  17. The service also provides command-line parameters which install, remove, or 
  18. run (debug) the service as a console application.
  19.  
  20. This sample (and service.c) is based on the win32\service sample.
  21.  
  22. FILES
  23. =====
  24.  
  25. The directory samples\rpc\handles\rpcsvc contains the following files to
  26. build the distributed application RPCSVC:
  27.  
  28. File          Description
  29.  
  30. README.TXT    Readme file for the RPCSVC sample
  31. RPCSVC.IDL    Interface definition language file
  32. RPCSVC.ACF    Attribute configuration file
  33. CLIENT.C      Client main program
  34. SERVER.C      Server main program
  35. SERVICE.C     Service APIs
  36. SERVICE.H
  37. MAKEFILE      Nmake file to build for Windows NT or Windows 95
  38.  
  39. TO USE:
  40. -------
  41.  
  42. To install the service, first compile everything, and then type:
  43.  
  44.   rpcsvc -install
  45.  
  46. To start the service, use the control panel or type:
  47.  
  48.   net start simplerpcservice
  49.  
  50. Once the service has been started, you can use the CLIENT program to verify 
  51. that it really is working, using the syntax:
  52.  
  53.   svcclnt [-i iterations] [-t protseq] [-n servername] [-s security]
  54.  
  55. By default, the service listens to ncalrpc, ncacn_np, ncacn_ip_tcp and 
  56. ncadg_ip_udp.  If no parameters are passed to the client, it uses ncalrpc 
  57. with default LPC security.
  58.     
  59. If, after playing with the sample you wish to remove the service, simply 
  60. run:
  61.  
  62.   rpcsvc -remove
  63.  
  64. You can run the service from the command line with:
  65.  
  66.   rpcsvc -debug
  67.  
  68. MORE INFORMATION:
  69. =================
  70.  
  71. See the sample in samples\win32\service for more information on NT system 
  72. service and how service.c and service.h work.
  73.  
  74. server.c implements a bunch of APIs:
  75.  
  76.     ServiceStart() is called when the server is starting. It uses server 
  77.     transports, registers its endpoints and interfaces and starts listening.
  78.  
  79.     ServiceStop() is called when the service should stop. It just calls 
  80.     RpcMgmtStopServerListening().
  81.  
  82.     Manager APIs (implement the remote side of the operations defined in the 
  83.     rpcsvc.idl file.
  84.  
  85. Client.c binds to the server (as specified on the command line) and then 
  86. times a bunch of different RPC calls to the server.
  87.