Win32-api 1.0.0

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

This forum is not affiliated to the Ruby language, Ruby on Rails framework, nor any Ruby applications discussed here.

| Privacy Policy | Terms of Service | Remote Ruby Jobs