[ANN] win32-api 1.0.0

[Daniel Berger]

Hi all,

The Win32Utils Team is happy to announce the first release of win32-api.

= What is it?
This is a replacement for the Win32API library that currently ships with
the Ruby standard library.

= Quick Synopsis
require 'win32/api'
include Win32

# Typical stuff
buf = 0.chr * 260
len = [@buf.length].pack('L')

GetUserName = API.new('GetUserName', 'PP', 'I', 'advapi32')
GetUserName.call(buf, len)

puts buf.strip

# Callback example
EnumWindows = API.new('EnumWindows', 'KP', 'L', 'user32')
GetWindowText = API.new('GetWindowText', 'LPI', 'I', 'user32')
EnumWindowsProc = API::Callback.new('LP', 'I'){ |handle, param|
buf = "\0" * 200
GetWindowText.call(handle, buf, 200);
puts buf.strip
buf.index(param).nil? ? true : false
}

EnumWindows.call(EnumWindowsProc, 'UEDIT32')

= What are the advantages over Win32API?
* Added callback support!
* Uses the Ruby 1.8.x allocation framework internally
* Now properly under the Win32 namespace
* Argument order change to the constructor that allows sensible defaults
* Better internal documentation
* It's actually maintained

= How do I get it?
There are two gems. Use the "mswin32" gem to install a prebuilt binary
(built via VC++ 6). Use the "plain" gem to build from source if you have
a compiler installed.

Or, you can download the source directly from the RubyForge project page
at http://www.rubyforge.org/projects/win32utils.

Enjoy!

The Win32Utils Team