home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / netds / ras / rasberry / readme.txt < prev    next >
Text File  |  1996-01-16  |  3KB  |  74 lines
  1. RASberry - A demonstation of the RAS API set.
  2.  
  3. THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
  4. ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
  5. THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
  6. PARTICULAR PURPOSE.
  7.  
  8. Copyright (C) 1993-1995  Microsoft Corporation.  All Rights Reserved.
  9.  
  10.  
  11. PURPOSE:
  12.     To demonstrate the Remote Access Service (RAS) API set.  RASberry
  13.     allows the user to enumerate current RAS connections, display the
  14.     status of a selected connection, dial entries from the default
  15.     phone book, and hang up a active connection.
  16.  
  17. RAS APIs USED:
  18.     RasDial
  19.     RasEnumConnections
  20.     RasEnumEntries
  21.     RasGetConnectStatus
  22.     RasGetErrorString
  23.     RasHangUp
  24.  
  25. COMMENTS:
  26.     This sample may be built as a 16 or 32 bit application.  The default
  27.     is 32 bits.  To build a 16 bit version, define MAK16 on the build
  28.     command line.
  29.  
  30.     32 BIT SPECIFICS:
  31.     - Before the application exits, it should insure that the RAS state
  32.       machine has been reset if there has been a hang up.  This may be 
  33.       done by calling Sleep(3000).  See documentation on RasHangUp for 
  34.       more information.
  35.  
  36.     - The 32 bit RasDial API can either function syncronously or
  37.       asyncronously.  This sample demonstrates the asyncronous ability.
  38.       The asyncronous RasDial call requires a callback function to
  39.       receive a notification of a change of state in the connection
  40.       process.  The function is not associated with a window or message
  41.       queue.  To provide a single source for both Win32 and Win16 
  42.       applications, the RasDialFunc in RASbeery, just posts a message
  43.       to a window, and the window's message handle takes the 
  44.       appropriate action. 
  45.  
  46.  
  47.     16 BIT SPECIFICS:
  48.     - The RasDial API is only asyncronous for Win16.  RasDial sends
  49.       a WM_RASDIALEVENT message to the window specified in the call to
  50.       RasDial.  An application may perform any tasks during the handling
  51.       of this message, but it should not call EndDialog().  If it is 
  52.       desired that the window be closed, a shut down message should be
  53.       posted to the window as in this sample.
  54.  
  55.  
  56. MODULE MAP:
  57.     RASberry- Implements message handlers for the main window.  Maintains
  58.               the list of current RAS connections.
  59.     StatDlg - Displays the status of a connection selected from the main
  60.               application window.
  61.     PhbkDlg - Displays contents of default phone book and allow the user
  62.               to dail an entry.
  63.     AuthDlg - Obtains authentication information from user before making
  64.               a connection.
  65.     DialDlg - Displays the states of the RAS connection during the initial
  66.               connection phase.
  67.     RasUtil - Utilities used by modules listed above.
  68.     Dispatch- Message dispatching routines
  69.     WinMain - Calls initialization functions and processes the message loop
  70.     Init    - Performs application and instance specific initialization
  71.     About   - Defines a standard about dialog box.
  72.     Misc    - Defines the applications specific commands not related to
  73.                 a specific module.
  74.