What has changed?

December 2007

Warning: This file is out of date and is not maintained at the moment. Refer to the projects website for more information.

January 2005

Note about dynamic linking

All conversions (except those functions that use the cdecl calling convention support dynamic loading through the DYNAMIC_LINK conditional directive (see ifdef.html). By default this feature is turned off. Please note that currently there is no way to find out upfront whether or not a required library is present on the system other than explicitly testing this yourself using LoadLibrary(), a future release might add support for this. In case the required library is not present on the system, an exception is raised. The exception is either EJwaLoadLibraryError or EJwaGetProcAddressError (both defined in JwaWinType and descended from EJwaError) if LoadLibrary() or GetProcAddress() fails respectively. Therefor, you'll need to protect your API calls using a try...except block like this:

  var
    H: HANDLE;
  begin
    try
      H := CreateFile(...);
      if H <> INVALID_HANDLE_VALUE then
      begin
        ...
        CloseHandle(H);
      end;
    except
      on EJwaError do
      begin
        // Either CreateFile or CloseHandle could not be found, handle that
        // situation somehow.
      end;
    end;
  end;
  

Known issues

Installation

The Win32 interface units do not need explicit installation but you do need to make sure that Delphi can find them. There are two ways to accomplish this, using Project Options or Environment Options. First you need to extract the zip into a directory of your liking, we'll refer to this directory as $(WIN32API). Now follow either of the steps outlined in the next two sections.

Using Project Options

From the IDE menu select "Project > Options" and switch to the "Directories/Conditionals" page in the dialog that appears. Find the edit box labelled "Search Path", type in the $(WIN32API) path and select OK. Alternatively you can use the ellipsis button to navigate to the directory in question. You will need to repeat this for every new project you start that uses the Win32 API interface units.

Using Environment Options

From the IDE menu select "Tools > Environment Options" and switch to the "Library" page in the dialog that appears. Find the edit box labelled "Library Path", it should contain something along the lines of "$(DELPHI)\Lib;$(DELPHI)\Bin;$(DELPHI)\Imports;$(DELPHI)\Projects\Bpl". Change this to include the $(WIN32API) directory. For example, assuming you've unzipped the Win32Api.zip file to "c:\win32api":
"$(DELPHI)\Lib;$(DELPHI)\Bin;$(DELPHI)\Imports;$(DELPHI)\Projects\Bpl;c:\win32api". Don't forget to seperate using a semicolon. You don't have to manually edit this string, you can press the ellipsis button to navigate to the $(WIN32API) directory and add it automatically. After pressing OK Delphi will be able to find the units for every new project without the need to specify the directory again.

If you performed the steps above you can start using the units in your application by including the appropriate ones in your uses clause. I personally prefer to use Project Options instead of Environment Options to avoid problems. One known problem is that when you use the Enironment Options method, you might get compiler errors when trying to build the JEDI Code Library.

Using the units

When you use these interface units keep in mind that they duplicate a lot of what's in the interface units that ship with Delphi, such as Windows.pas. These units can co-exist but you need to make sure that you do not mix the usage of them too much. For example, either use Windows.pas or the equivalents in this library but not both, otherwise you might run into incompatibilities between them resulting in compile errors. The easiest way is to not include both in the uses clause of your own units. If this is impossible for some reason you're best of using explicit unit qualification when using anything. For example, instead of using "CreateProcess" use either "Windows.CreateProcess" or "JwaWinBase.CreateProcess". If you do not use unit qualification you end up using the one from the unit last mentioned in the uses clause.

The most common error you're likely to encounter is: "Incompatible types: 'System.WideChar' and 'JwaWinType'.WideChar" where WideChar is only an example. This is due to the fact that the RTL (e.g. System.pas or Windows.pas) defines the type WideChar differently from WinType.pas. To solve this simply change the declaration in JwaWinType.pas to become an alias for the type in System.pas (or Windows.pas). For example Before:

  type
    DWORD = Longword;
  
After:
  type
    DWORD = Windows.DWORD;
  
If you look inside JwaWinType.pas you see that I've already done this for the most common types (using conditional compilation) like this
  type
    DWORD = {$IFDEF USE_DELPHI_TYPES}Windows.DWORD{$ELSE}Longword{$ENDIF};
  
therefore it's unlikely you'll run into this problem. However, if you do please notify me so I can update the interface units.

Please note that these units heavily use conditional compilation. You can globally change some settings, and thereby determine how they get compiled, through the WinDefines.inc include file. An example of this would be to specify an unicode build. There are a few more directives which cannot be set globally (yet), Initial documentation for the directives can be found in ifdef.html.

Copyright

These units are distributed under the terms of of the MPL, or optionally the terms of the LGPL. What this means is that they are completely free and can be used in all development, even commercial applications. I have a few requests though:

Please be aware that the WinLDAP unit was created by Luk Vermeulen and can only be used and distributed under the MPL license. It's included because of dependencies on this unit. We may convert the header ourselves one day.