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