Return to readme.txt CVS log

Up to [WindowsNT SDKs] / mstools / samples / rpc / cluuid

Annotation of mstools/samples/rpc/cluuid/readme.txt, revision 1.1.1.1

1.1       root        1: This directory contains the files for the sample
                      2: distributed application "cluuid":
                      3: 
                      4: File          Description
                      5: 
                      6: README.TXT    Readme file for the cluuid sample
                      7: CLUUID.IDL    Interface definition language file
                      8: CLUUID.ACF    Attribute configuration file
                      9: CLUUIDC.C     Client main program
                     10: CLUUIDS.C     Server main program
                     11: CLUUIDP.C     Remote procedures
                     12: MAKEFILE      Nmake file to build for NT
                     13: MAKEFILE.DOS  Nmake file to build for MS-DOS
                     14: 
                     15: This sample program demonstrates how to supply
                     16: multiple implementations of the remote procedure
                     17: specified in the interface.  It also demonstrates
                     18: how the client selects among the implementations
                     19: by providing a client object uuid.
                     20: 
                     21: The server calls RpcObjectSetType to associate a
                     22: client object uuid with the object uuid in the
                     23: Object Registry Table. The server initializes a
                     24: manager entry point vector (manager epv) and
                     25: then calls RpcRegisterIf to associate the interface
                     26: uuid and the object uuid with the manager epv in the
                     27: Interface Registry Table.
                     28: 
                     29: When the client makes a remote procedure call,
                     30: the client object uuid is mapped to the object uuid
                     31: in the Object Registry Table.  The resulting
                     32: object uuid and the interface uuid are mapped to
                     33: a manager entry point vector in the Interface
                     34: Registry Table.
                     35: 
                     36: By default, in this example, the server registers
                     37: two implementations of the "hello, world" function
                     38: HelloProc and HelloProc2.  The HelloProc2
                     39: implementation is associated with the object uuid
                     40: "11111111-1111-1111-1111-111111111111". When
                     41: the client makes a procedure call with a null
                     42: uuid, the client's request is mapped to the
                     43: original HelloProc.  When the client makes a
                     44: procedure call with the client object uuid
                     45: "11111111-1111-1111-1111-11111111111", the
                     46: client's request is mapped to HelloProc2 (which
                     47: prints the string in reverse).
                     48: 
                     49: -------------------------------------------
                     50: BUILDING CLIENT AND SERVER APPLICATIONS FOR
                     51: MICROSOFT WINDOWS NT:
                     52: -------------------------------------------
                     53: 
                     54: The following environment variables should be set for you already.           
                     55:   set CPU=i386                                                               
                     56:   set INCLUDE=c:\mstools\h                                                   
                     57:   set LIB=c:\mstools\lib                                                     
                     58:   set PATH=c:\winnt\system32;c:\mstools\bin;
                     59:                                                                              
                     60: For mips, set CPU=mips                                                       
                     61:                                                                              
                     62: Build the sample distributed application:
                     63:   nmake cleanall
                     64:   nmake
                     65: 
                     66: This builds the executable programs cluuidc.exe
                     67: (client) and cluuids.exe (server).
                     68: 
                     69: ------------------------------------------
                     70: BUILDING THE CLIENT APPLICATION FOR MS-DOS
                     71: ------------------------------------------
                     72: 
                     73: After you install the Microsoft C/C++ version 7.0
                     74: development environment and the Microsoft RPC version
                     75: 1.0 toolkit on an MS-DOS or Microsoft Windows computer,
                     76: you can build the sample client application for MS-DOS.
                     77: Enter:
                     78: 
                     79:   nmake -f makefile.dos cleanall
                     80:   nmake -f makefile.dos
                     81: 
                     82: This builds the client application cluuidc.exe.
                     83: 
                     84: ------------------------------------------
                     85: RUNNING THE CLIENT AND SERVER APPLICATIONS
                     86: ------------------------------------------
                     87: 
                     88: On the server, enter
                     89: 
                     90:   cluuids
                     91: 
                     92: On the client, enter
                     93: 
                     94:   net start workstation
                     95:   cluuidc
                     96: 
                     97: To call the second implementation of the function,
                     98: on the client, enter
                     99:   cluuidc -u "11111111-1111-1111-1111-111111111111"
                    100: 
                    101: Note:  The client and server applications can run on
                    102: the same Microsoft Windows NT computer when you use
                    103: different screen groups.
                    104: 
                    105: Several command line switches are available to change
                    106: settings for this program. For a listing of the switches
                    107: available from the client program, enter
                    108: 
                    109:   cluuidc -?
                    110: 
                    111: For a listing of switches available from the server 
                    112: program, enter
                    113: 
                    114:   cluuids -?

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.