DOCERR: Errors in Win32s Compatibility
  
PSS ID Number: Q113679
Article last modified on 05-10-1996
 
1.20 1.25a
 
WINDOWS
 

----------------------------------------------------------------------
The information in this article applies to:
 
 - Microsoft Win32s versions 1.2 and 1.25a
----------------------------------------------------------------------
 
SUMMARY
=======
 
The following Win32 APIs are listed in the Win32 Programmer's Reference as
being supported under Win32s. This is incorrect. These Win32 APIs are not
supported under Win32s:
 
  - mouse_event
 
The following Win32 APIs are not listed in the Win32 Programmer's Reference
as being supported under Win32s. This is incorrect. These Win32 APIs are
supported under Win32s:
 
   FlushInstructionCache
   GetFileInformationByHandle
   MoveMemory
   TlsAlloc
   RegCreateKeyEx
   RegOpenKeyEx
   RegSetValueEx
   WNetAddConnection
   WNetGetConnection
 
In addition, all of the BS_ button styles are marked as not supported under
Win32s. However, Win32s supports all of the button styles that Windows 3.1
supports.
 
MORE INFORMATION
================
 
The following Win32 APIs and CRT (C Run-time) routines are supported under
Win32s, with the restrictions noted.
 
Function                        Associated Restriction
===========================================================================
CreateFile                      FILE_FLAG_NO_BUFFERING,
                                FILE_FLAG_WRITE_THROUGH,
                                FILE_FLAG_OVERLAPPED, FILE_DELETE_ON_CLOSE,
                                and the security flags are not supported.
                                Passing dwShareMode=0 opens the file in
                                compatibility mode, not in exclusive mode.
---------------------------------------------------------------------------
CreateFileMapping               SEC_COMMIT is supported, but not
                                SEC_IMAGE, SEC_NOCACHE or SEC_RESERVE.
                                The size of named shared memory is limited
                                by Windows memory.
---------------------------------------------------------------------------
CreateDIBitmap                  DIB_PAL_INDICES
CreateDIBPatternBrush           DIB_PAL_PHYSINDICES
CreateDIBPatternBrushPt         DIB_PAL_LOGINDICES   are not supported.
GetDIBits
SetDIBits
SetDIBitsToDevice
StretchDIBits
---------------------------------------------------------------------------
CreatePolyPolygonRgn            The polygon must be closed.
---------------------------------------------------------------------------
CreateProcess                   Handle inheritance is not supported.
                                Only creation flags supported are
                                DEBUG_PROCESS and DEBUG_ONLY_THIS_PROCESS.
                                The only priority supported is
                                NORMAL_PRIORITY_CLASS. The security
                                attributes are ignored.
---------------------------------------------------------------------------
GetFileInformationByHandle      ftCreationTime, ftLastAccessTime,
                                dwVolumeSerialNumber, nFileIndexHigh, and
                                nFileIndexLow are all 0.
---------------------------------------------------------------------------
GetFileTime                     Only lpLastWriteTime is supported.
SetFileTime
---------------------------------------------------------------------------
GetPrivateProfileString         lpszSection parameter cannot be NULL.
GetProfileString
---------------------------------------------------------------------------
GetSystemMetrics                SM_CMOUSEBUTTONS is not supported.
---------------------------------------------------------------------------
GetSystemPaletteEntries         The fourth parameter cannot be NULL.
---------------------------------------------------------------------------
GetVolumeInformation            Volume ID is not supported.
---------------------------------------------------------------------------
OpenProcess                     Settings for fdwAccess and fInherit are
                                ignored. In the implementation,
                                fdwAccess=PROCESS_ALL_ACCESS and
                                fInherit=TRUE.
---------------------------------------------------------------------------
PeekMessage                     hWnd cannot be -1.
---------------------------------------------------------------------------
PlaySound                       SND_ALIAS, SND_FILENAME, and
                                SND_NOWAIT are not supported.
---------------------------------------------------------------------------
RegSetValueEx                   Only supports the REG_SZ entries.
---------------------------------------------------------------------------
SetClipboardData                Use only a global handle.
---------------------------------------------------------------------------
SetWindowsHookEx                dwThreadId parameter is ignored.
---------------------------------------------------------------------------
signal                          SIGBREAK is not supported.
---------------------------------------------------------------------------
spawn                           P_WAIT is not supported.
---------------------------------------------------------------------------
WaitForDebugEvent               Any dwTimeOut other than 0 is treated as
                                INFINITE.
---------------------------------------------------------------------------
WNetAddConnection               Password cannot be NULL, but can be "".
===========================================================================
 
Additional reference words: 1.20
KBCategory: kbref kbdocerr
KBSubcategory: W32s
=============================================================================
Copyright Microsoft Corporation 1996.
