home *** CD-ROM | disk | FTP | other *** search
/ PC Open 18 / pcopen18_giallo.iso / Win95 / SDK / DOCS / README / DPLAY.TXT < prev    next >
Encoding:
Text File  |  1997-07-14  |  6.2 KB  |  148 lines
  1. DirectPlay 5.0 Release Notes:
  2.  
  3. 1. Security and Authentication
  4. ------------------------------
  5. In order to host a secure DirectPlay session using the default security
  6. provider (NTLM), you will need to host it on NT 4.0 (Workstation or Server).
  7. Clients may use either NT or Windows 95.  Instructions for installing
  8. DirectPlay on NT are provided below.
  9.  
  10. Accounts will need to created on the NT system that is hosting the
  11. session. This can be done using the "User Manager for Domains" in the
  12. Administrative Tools program group.  If the NT system hosting the session
  13. is already logged into a domain then accounts on the domain may also be
  14. used.
  15.  
  16. If the client machine is already logged into the NT domain, an application
  17. will not need to supply credentials when connecting to a secure DirectPlay
  18. session.  Otherwise, credentials will need to supplied by the application
  19. using IDirectPlay3::SecureOpen()
  20.  
  21. Security may only be used in client/server sessions.
  22.  
  23. Installing DirectPlay 5 on NT 4.0 with SP3
  24. ------------------------------------------
  25. NOTE: These instructions are being given for testing purposes only. This
  26. must not be used to ship products using DirectPlay v5 that wish to run on
  27. NT.  Consult the DirectX web site - http:://www.microsoft.com/DirectX for an
  28. official installation program for DirectPlay.
  29.  
  30. 1. Copy the DirectPlay DLLs to the WinNT/System32 directory. These DLLs
  31.    are: dplaysvr.exe, dplayx.dll, dpwsockx.dll, dpmodemx.dll
  32.  
  33. 2. Add the registry entries needed for DirectPlay.  The file
  34.    DPLAYNT.REG on the SDK CD in the \extras\dplay directory will do this
  35.    for you.  Simply double-click on this file to install it.
  36.  
  37. 3. You are now ready to host a secure session on your NT 4.0 machine.
  38.    Be sure to specify the DPSESSION_SECURESERVER flag in the DPSESSIONDESC2
  39.    structure when you create the session.
  40.  
  41.  
  42.  
  43. 2. Stricter Parameter Validation
  44. --------------------------------
  45. Stricter parameter validation has been added to DirectPlay to trap cases
  46. where applications set unused bits in flags.  Code that may have worked
  47. before under previous versions of DirectPlay may now return an error if
  48. invalid bits are set in flags parameters.
  49.  
  50. Methods which take structures MUST have the dwSize member filled in with the
  51. correct size of the structure - sizeof(STRUCTURE) - or an invalid parameter
  52. error will be returned. This is so that DirectPlay can tell what version of
  53. a structure is being requested by the application.  CreatePlayer is a
  54. function that is now doing this.
  55.  
  56. In most cases, the most helpful way to determine what the problem is with
  57. invalid parameter errors is to run the application using DEBUG versions of
  58. the DirectX DLLs and watch the debug output.  It will usually give a message
  59. indicating what the problem was.
  60.  
  61.  
  62. 3. Sample Lobby Server
  63. ----------------------
  64.  
  65. Included on the SDK is a sample lobby server and lobby client that use
  66. the DirectPlay APIs and the lobby provider architecture.  Consult the
  67. README.TXT in the DXSDK\SDK\SAMPLES\BELLHOP directory for instructions on
  68. setting this up.
  69.  
  70. 4. DirectPlay Bug Fixes
  71. -----------------------
  72. Many bugs reported in DirectPlay3 have been fixed in DirectPlay5.  These
  73. fixes will work for any application compiled with the DX3 SDK but where
  74. the DX5 runtime is installed on the system.
  75.  
  76. - Two or more clients can now join a session simultaneously without losing
  77.   any players
  78. - Attempting to host a second session on a machine using IPX will now return 
  79.   an error
  80. - Attempting to set the name or remote data on a player or group you don't 
  81.   own will now result in a DPERR_ACCESSDENIED message.
  82. - Attempting to enumerate sessions a second time using the modem service 
  83.   provider will no longer return a "Line Already In Use" error,
  84. - IDirectPlayLobby2::Connect() now connects to a remote session much faster
  85. - All service providers now return DPERR_USERCANCEL if the user cancelled
  86.   the service provider dialog
  87. - DDHELP.EXE no longer statically linked the wsock32.dll so you don't need
  88.   to have Winsock installed to run a DirectDraw only application
  89. - Group management functions that used to return DPERR_INVALIDPLAYER now
  90.   return DPERR_INVALIDGROUP
  91. - DirectPlay now returns an error if the IPX binding from the network adapter
  92.   on Windows 95
  93. - Opening and closing a session on the same instance of a DirectPlay interface
  94.   now works
  95. - The modem service provider will prompt for a phone number each time a
  96.   new interface is created
  97. - EnumSessions will return password protected sessions without having to
  98.   supply the password in advance
  99.  
  100. 5. General Notes
  101. ----------------
  102.  
  103. -- You can find out the IP address of your machine on Windows 95 by running
  104.    "winipcfg".  On NT use "ipconfig"
  105.  
  106.    If you have a net card and a modem installed, you will need to make
  107.    sure you read the IP address of the modem connection to the Internet.
  108.    The IP address information for the modem will typically show up under
  109.    "PPP Adapter".
  110.  
  111. -- The IPX service provider will not cross routers.
  112.  
  113. -- The IPX, modem and serial service providers do not implement guaranteed
  114.    messaging.
  115.  
  116.  
  117.  
  118. 6. Known Limitations
  119. --------------------
  120.  
  121. Many of these limitations will be corrected in a future release of
  122. DirectPlay. Consult the DirectX web site - http:://www.microsoft.com/DirectX
  123. for updated information.
  124.  
  125. -- There is no multi-home support for IPX.  Use TCP/IP if multi-homing
  126.    is needed.
  127.  
  128. -- DirectPlay generally will not work through proxies and firewalls.
  129.  
  130. -- If a player drops out of the session due to a lost connection, new
  131.    players will not be able to join the session for approximately
  132.    1.5 minutes.  This is only a problem on the TCP/IP service provider.
  133.  
  134. -- A multicast server may lose messages during long data transfers.
  135.  
  136. -- Encrypted or signed messages can only be sent guaranteed and only between
  137.    a client and a server player.
  138.  
  139. -- When joining a secure client/server session, the client machine must
  140.    set the DPSESSIONDESC2.dwFlags member to zero before calling
  141.    IDirectPlay3::Open with the DPOPEN_JOIN flag otherwise a
  142.    DPERR_INVALIDFLAGS error will be returned.
  143.  
  144. -- The DPSEND_ENCRYPTED and DPSEND_SIGNED flags cannot be used when sending
  145.    messages to a group.  If security is required, send individual messages
  146.    to each player in the group.
  147.  
  148.