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 / strout / readme.txt < prev    next >
Encoding:
Text File  |  1996-07-23  |  2.2 KB  |  61 lines
  1. STROUT  
  2.  
  3.  
  4. The STROUT sample demonstrates how to allocate memory at a server for 
  5. a two-dimensional object (an array of pointers) and pass it back to the 
  6. client as an [out]-only parameter. The client then frees the memory. 
  7. This technique allows the stub to call the server without knowing in 
  8. advance how much data will be returned.
  9. This program also allows the user to compile either for UNICODE or ANSI.
  10. See section below for guidelines on how to compile for UNICODE
  11.  
  12.  
  13. FILES 
  14. ===== 
  15.  
  16. The directory samples\rpc\strout contains the following files for
  17. building the sample distributed application STROUT: 
  18.  
  19. File          Description
  20. -------------------------
  21.  
  22. README.TXT      Readme file for the strout sample 
  23. STROUT.IDL      Interface definition language file 
  24. STROUT.ACF      Attribute configuration file 
  25. CLIENT.C        Client main program 
  26. SERVER.C        Server main program 
  27. COMMON.H        Common header file for all the files
  28. REMOTE.C        Remote procedures 
  29. MAKEFILE        nmake file to build 32-bit client and server applications
  30.                 for ANSI characters.
  31. MAKEFILE.UNI    nmake file to build 32-bit client and server applications
  32.                 for UNICODE characters.
  33.  
  34. NMAKE builds the executable programs CLIENT.EXE (client) and
  35. SERVER.EXE (server).
  36.  
  37. Note: The client and server applications can run on the same 
  38. Microsoft Windows NT computer when you use different screen groups.
  39.  
  40.  
  41.  
  42. COMPILING FOR UNICODE:
  43. ======================
  44.  
  45. type nmake /f makefile.uni at the command line. This will cause
  46. the compiler to use the file MAKEFILE.UNI instead of the MAKEFILE.
  47.     
  48.  
  49. The reason behind the use of TEXT, TCHAR, _TUCHAR, _tprintf, _tcscpy, 
  50. _tcscmp, and _tcslen is that these macros expand to either 
  51. one byte character ANSI functions or to UNICODE (Wide characters) functions
  52. when they are compiled
  53.     TEXT    :   This macro will put an L in front of the string if we are 
  54.                 compiling for UNICODE
  55.     TCHAR   :   Maps to either char or wchar_t 
  56.     _TUCHAR :   Maps to either unsigned char or wchar_t 
  57.     _tprintf:   Maps to either printf or wsprintf
  58.     _tcslen :   Maps to either strlen or wcslen
  59.     _tcscpy :   Maps to either strcpy or wcscpy
  60.     _tcscmp :   Maps to either strcmp or wcscmp
  61.