windows-pr 0.6.6 → 0.7.0

data/lib/windows/service.rb

@@ -1,7 +1,13 @@
-require 'Win32API'
+require 'windows/api'
+include Windows
 
 module Windows
    module Service
+      API.auto_namespace = 'Windows::Service'
+      API.auto_constant  = true
+      API.auto_method    = true
+      API.auto_unicode   = true
+
       # SCM access rights
       SC_MANAGER_ALL_ACCESS         = 0xF003F
       SC_MANAGER_CREATE_SERVICE     = 0x0002
@@ -100,84 +106,32 @@ module Windows
       SERVICE_CONFIG_REQUIRED_PRIVILEGES_INFO = 6
       SERVICE_CONFIG_PRESHUTDOWN_INFO         = 7
       
-      ChangeServiceConfig           = Win32API.new('advapi32', 'ChangeServiceConfig', 'LLLLPPPPPPP', 'I')
-      ChangeServiceConfig2          = Win32API.new('advapi32', 'ChangeServiceConfig2', 'LLP', 'I')
-      CloseServiceHandle            = Win32API.new('advapi32', 'CloseServiceHandle', 'L', 'I')
-      ControlService                = Win32API.new('advapi32', 'ControlService', 'LLP', 'I')
-      CreateService                 = Win32API.new('advapi32', 'CreateService', 'LPPLLLLPPPPPP', 'L')
-      DeleteService                 = Win32API.new('advapi32', 'DeleteService', 'L', 'I')
-      EnumDependentServices         = Win32API.new('advapi32', 'EnumDependentServices', 'LLPLPP', 'I')
-      EnumServicesStatus            = Win32API.new('advapi32', 'EnumServicesStatus', 'LLLPLPPP', 'I')
-      EnumServicesStatusEx          = Win32API.new('advapi32', 'EnumServicesStatusEx', 'LLLLPLPPPP', 'I')
-      GetServiceDisplayName         = Win32API.new('advapi32', 'GetServiceDisplayName', 'LPPP', 'I')
-      GetServiceKeyName             = Win32API.new('advapi32', 'GetServiceKeyName', 'LPPP', 'I')
-      LockServiceDatabase           = Win32API.new('advapi32', 'LockServiceDatabase', 'L', 'L')
-      NotifyBootConfigStatus        = Win32API.new('advapi32', 'NotifyBootConfigStatus', 'I', 'I')
-      OpenSCManager                 = Win32API.new('advapi32', 'OpenSCManager', 'PPL', 'L')
-      OpenService                   = Win32API.new('advapi32', 'OpenService', 'LPL', 'L')
-      QueryServiceConfig            = Win32API.new('advapi32', 'QueryServiceConfig', 'LPLP', 'I')
-      QueryServiceConfig2           = Win32API.new('advapi32', 'QueryServiceConfig2', 'LLPLP', 'I')
-      QueryServiceLockStatus        = Win32API.new('advapi32', 'QueryServiceLockStatus', 'LPLP', 'I')
-      QueryServiceStatus            = Win32API.new('advapi32', 'QueryServiceStatus', 'LP', 'I')
-      QueryServiceStatusEx          = Win32API.new('advapi32', 'QueryServiceStatusEx', 'LLPLP', 'I')
-      RegisterServiceCtrlHandler    = Win32API.new('advapi32', 'RegisterServiceCtrlHandler', 'PP', 'L')
-      RegisterServiceCtrlHandlerEx  = Win32API.new('advapi32', 'RegisterServiceCtrlHandlerEx', 'PPP', 'L')
-      SetServiceBits                = Win32API.new('advapi32', 'SetServiceBits', 'LLII', 'I')
-      SetServiceStatus              = Win32API.new('advapi32', 'SetServiceStatus', 'LP', 'I')
-      StartService                  = Win32API.new('advapi32', 'StartService', 'LLP', 'I')
-      StartServiceCtrlDispatcher    = Win32API.new('advapi32', 'StartServiceCtrlDispatcher', 'P', 'I')
-      UnlockServiceDatabase         = Win32API.new('advapi32', 'UnlockServiceDatabase', 'L', 'I')
-   
-      def CloseServiceHandle(handle)
-         CloseServiceHandle.call(handle) != 0
-      end
-      
-      def ControlService(service, control, status)
-         ControlService.call(service, control, status) != 0
-      end
-      
-      def DeleteService(handle)
-         DeleteService.call(handle) != 0
-      end
-      
-      def EnumServicesStatusEx(handle, info, s_type, s_state, services, size, bytes, s_returned, rhandle, grp)
-         EnumServicesStatusEx.call(handle, info, s_type, s_state, services, size, bytes, s_returned, rhandle, grp) != 0
-      end
-      
-      def GetServiceDisplayName(handle, service, display, buf)
-         GetServiceDisplayName.call(handle, service, display, buf) != 0
-      end
-      
-      def GetServiceKeyName(handle, display, service, buf)
-         GetServiceKeyName.call(handle, display, service, buf) != 0
-      end
-      
-      def OpenSCManager(host, database, access)
-         OpenSCManager.call(host, database, access)
-      end
-      
-      def OpenService(handle, service, access)
-         OpenService.call(handle, service, access)
-      end
-
-      def QueryServiceConfig(handle, buf, buf_size, bytes)
-         QueryServiceConfig.call(handle, buf, buf_size, bytes) != 0
-      end
-
-      def QueryServiceConfig2(handle, info, buf, buf_size, bytes)
-         QueryServiceConfig2.call(handle, info, buf, buf_size, bytes) != 0
-      end
-      
-      def QueryServiceStatusEx(service, info, buf, size, bytes)
-         QueryServiceStatusEx.call(service, info, buf, size, bytes) != 0
-      end
-      
-      def QueryStatusConfig2(service, info, buf, size, bytes)
-         QueryStatusConfig2.call(service, info, buf, size, bytes) != 0
-      end
-
-      def StartService(handle, num_vec, vec)
-         StartService.call(handle, num_vec, vec)
-      end
+      API.new('ChangeServiceConfig', 'LLLLPPPPPPP', 'B', 'advapi32')
+      API.new('ChangeServiceConfig2', 'LLP', 'B', 'advapi32')
+      API.new('CloseServiceHandle', 'L', 'B', 'advapi32')
+      API.new('ControlService', 'LLP', 'B', 'advapi32')
+      API.new('CreateService', 'LPPLLLLPPPPPP', 'L', 'advapi32')
+      API.new('DeleteService', 'L', 'B', 'advapi32')
+      API.new('EnumDependentServices', 'LLPLPP', 'B', 'advapi32')
+      API.new('EnumServicesStatus', 'LLLPLPPP', 'B', 'advapi32')
+      API.new('EnumServicesStatusEx', 'LLLLPLPPPP', 'B', 'advapi32')
+      API.new('GetServiceDisplayName', 'LPPP', 'B', 'advapi32')
+      API.new('GetServiceKeyName', 'LPPP', 'B', 'advapi32')
+      API.new('LockServiceDatabase', 'L', 'L', 'advapi32')
+      API.new('NotifyBootConfigStatus', 'I', 'B', 'advapi32')
+      API.new('OpenSCManager', 'PPL', 'L', 'advapi32')
+      API.new('OpenService', 'LPL', 'L', 'advapi32')
+      API.new('QueryServiceConfig', 'LPLP', 'B', 'advapi32')
+      API.new('QueryServiceConfig2', 'LLPLP', 'B', 'advapi32')
+      API.new('QueryServiceLockStatus', 'LPLP', 'B', 'advapi32')
+      API.new('QueryServiceStatus', 'LP', 'B', 'advapi32')
+      API.new('QueryServiceStatusEx', 'LLPLP', 'B', 'advapi32')
+      API.new('RegisterServiceCtrlHandler', 'PP', 'L', 'advapi32')
+      API.new('RegisterServiceCtrlHandlerEx', 'PPP', 'L', 'advapi32')
+      API.new('SetServiceBits', 'LLII', 'B', 'advapi32')
+      API.new('SetServiceStatus', 'LP', 'B', 'advapi32')
+      API.new('StartService', 'LLP', 'B', 'advapi32')
+      API.new('StartServiceCtrlDispatcher', 'P', 'B', 'advapi32')
+      API.new('UnlockServiceDatabase', 'L', 'B', 'advapi32')
    end
 end

data/lib/windows/shell.rb

@@ -1,7 +1,13 @@
-require 'Win32API'
+require 'windows/api'
+include Windows
 
 module Windows
    module Shell
+      API.auto_namespace = 'Windows::Shell'
+      API.auto_constant  = true
+      API.auto_method    = true
+      API.auto_unicode   = true
+
       # CSIDL constants
       CSIDL_DESKTOP                 = 0x0000
       CSIDL_INTERNET                = 0x0001
@@ -69,20 +75,8 @@ module Windows
       SHGFP_TYPE_CURRENT = 0
       SHGFP_TYPE_DEFAULT = 1
 
-      SHGetFolderPath            = Win32API.new('shell32', 'SHGetFolderPath', 'LLLLP', 'L')
-      SHGetSpecialFolderLocation = Win32API.new('shell32', 'SHGetSpecialFolderLocation', 'LIP', 'L')
-      SHGetSpecialFolderPath     = Win32API.new('shell32', 'SHGetSpecialFolderPath', 'LPLL','L')
-
-      def SHGetFolderPath(handle, folder, token, flags, path)
-         SHGetFolderPath.call(handle, folder, token, flags, path)
-      end
-
-      def SHGetSpecialFolderLocation(handle, folder, pidl)
-         SHGetSpecialFolderLocation.call(handle, folder, pidl)
-      end
-
-      def SHGetSpecialFolderPath(handle, path, folder, create)
-         SHGetSpecialFolderPath.call(handle, path, folder, create)
-      end
+      API.new('SHGetFolderPath', 'LLLLP', 'L', 'shell32')
+      API.new('SHGetSpecialFolderLocation', 'LIP', 'L', 'shell32')
+      API.new('SHGetSpecialFolderPath', 'LPLL','L', 'shell32')
    end
 end

data/lib/windows/sound.rb

@@ -1,33 +1,13 @@
-##############################################################################
-# sound.rb
-#
-# Includes the following functions:
-#
-# Beep()
-# PlaySound()
-# WaveOutSetVolume()
-# WaveOutGetVolume()
-#
-# Defines the following constants:
-# 
-# SND_APPLICATION
-# SND_ALIAS
-# SND_ALIAS_ID
-# SND_ASYNC
-# SND_FILENAME
-# SND_LOOP
-# SND_MEMORY
-# SND_NODEFAULT
-# SND_NOSTOP
-# SND_NOWAIT
-# SND_PURGE
-# SND_RESOURCE
-# SND_SYNC
-##############################################################################
-require 'Win32API'
+require 'windows/api'
+include Windows
 
 module Windows  
    module Sound
+      API.auto_namespace = 'Windows::Sound'
+      API.auto_constant  = false  # Because of lowercase method names
+      API.auto_method    = true
+      API.auto_unicode   = true
+
       SND_SYNC          = 0x0000  # play synchronously (default)
       SND_ASYNC         = 0x0001  # play asynchronously
       SND_NODEFAULT     = 0x0002  # silence (!default) if sound not found
@@ -44,9 +24,15 @@ module Windows
       SND_PURGE         = 0x0040  # purge non-static events for task
       SND_APPLICATION   = 0x0080  # look for application specific association
       
-      Beep             = Win32API.new('kernel32', 'Beep', 'LL', 'I')
-      PlaySound        = Win32API.new('winmm', 'PlaySound', 'PPL', 'I')
-      WaveOutSetVolume = Win32API.new('winmm', 'waveOutSetVolume', 'PL', 'I')
-      WaveOutGetVolume = Win32API.new('winmm', 'waveOutGetVolume', 'IP', 'I')
+      Beep              = API.new('Beep', 'LL', 'B')
+      PlaySound         = API.new('PlaySound', 'PPL', 'B', 'winmm')
+      WaveOutSetVolume  = API.new('waveOutSetVolume', 'PL', 'I', 'winmm')
+      WaveOutGetVolume  = API.new('waveOutGetVolume', 'IP', 'I', 'winmm')
+      WaveOutGetNumDevs = API.new('waveOutGetNumDevs', 'V', 'I', 'winmm')
+      WaveInGetNumDevs  = API.new('waveInGetNumDevs', 'V', 'I', 'winmm')
+      MidiOutGetNumDevs = API.new('midiOutGetNumDevs', 'V', 'I', 'winmm')
+      MidiInGetNumDevs  = API.new('midiInGetNumDevs', 'V', 'I', 'winmm')
+      AuxGetNumDevs     = API.new('auxGetNumDevs', 'V', 'I', 'winmm')
+      MixerGetNumDevs   = API.new('mixerGetNumDevs', 'V', 'I', 'winmm')
    end
 end

data/lib/windows/synchronize.rb

@@ -1,7 +1,13 @@
-require 'Win32API'
+require 'windows/api'
+include Windows
 
 module Windows
    module Synchronize
+      API.auto_namespace = 'Windows::Synchronize'
+      API.auto_constant  = true
+      API.auto_method    = true
+      API.auto_unicode   = true
+
       INFINITE       = 0xFFFFFFFF
       WAIT_OBJECT_0  = 0
       WAIT_TIMEOUT   = 0x102
@@ -37,94 +43,22 @@ module Windows
       SEMAPHORE_ALL_ACCESS   = 0x1F0003
       SEMAPHORE_MODIFY_STATE = 0x0002
 
-      CreateEvent     = Win32API.new('kernel32', 'CreateEvent', 'PIIP', 'L')
-      CreateMutex     = Win32API.new('kernel32', 'CreateMutex', 'PIP', 'L')
-      CreateSemaphore = Win32API.new('kernel32', 'CreateSemaphore', 'PLLP', 'L')
-
-      GetOverlappedResult = Win32API.new('kernel32', 'GetOverlappedResult', 'LPPI', 'I')
-      
-      MsgWaitForMultipleObjects   = Win32API.new('user32', 'MsgWaitForMultipleObjects', 'LPILL', 'L')
-      MsgWaitForMultipleObjectsEx = Win32API.new('user32', 'MsgWaitForMultipleObjectsEx', 'LPLLL', 'L')
-
-      OpenEvent        = Win32API.new('kernel32', 'OpenEvent', 'LIP', 'L')
-      OpenMutex        = Win32API.new('kernel32', 'OpenMutex', 'LIP', 'L')
-      OpenSemaphore    = Win32API.new('kernel32', 'OpenSemaphore', 'LIP', 'L')
-      ReleaseMutex     = Win32API.new('kernel32', 'ReleaseMutex', 'L', 'I')
-      ReleaseSemaphore = Win32API.new('kernel32', 'ReleaseSemaphore', 'LLP', 'I')
-      ResetEvent       = Win32API.new('kernel32', 'ResetEvent', 'L', 'I')
-      SetEvent         = Win32API.new('kernel32', 'SetEvent', 'L', 'I')
-
-      WaitForMultipleObjects   = Win32API.new('kernel32', 'WaitForMultipleObjects', 'LPIL', 'L')
-      WaitForMultipleObjectsEx = Win32API.new('kernel32', 'WaitForMultipleObjectsEx', 'LPILI', 'L')
-      WaitForSingleObject      = Win32API.new('kernel32', 'WaitForSingleObject', 'LL', 'L')
-      WaitForSingleObjectEx    = Win32API.new('kernel32', 'WaitForSingleObjectEx', 'LLI', 'L')
-      
-      def CreateEvent(attributes, reset, state, name)
-         CreateEvent.call(attributes, reset, state, name)
-      end
-      
-      def CreateMutex(attributes, owner, name)
-         CreateMutex.call(attributes, owner, name)
-      end
-      
-      def CreateSemaphore(attributes, initial, max, name)
-         CreateSemaphore.call(attributes, initial, max, name)
-      end
-      
-      def GetOverlappedResult(handle, overlapped, bytes_transferred, wait)
-         GetOverlappedResult.call(handle, overlapped, bytes_transferred, wait)
-      end
-      
-      def MsgWaitForMultipleObjects(count, handles, wait, milli, mask)
-         MsgWaitForMultipleObjects.call(count, handles, wait, milli, mask)
-      end
-      
-      def MsgWaitForMultipleObjectsEx(count, handles, milli, mask, flags)
-         MsgWaitForMultipleObjectsEx.call(count, handles, milli, mask, flags)
-      end
-      
-      def OpenSemaphore(access, handle, name)
-         OpenSemaphore.call(access, handle, name)
-      end
-      
-      def OpenMutex(access, handle, name)
-         OpenMutex.call(access, handle, name)
-      end
-      
-      def OpenEvent(access, handle, name)
-         OpenEvent.call(access, handle, name)
-      end
-      
-      def ReleaseMutex(handle)
-         ReleaseMutex.call(handle) != 0
-      end
-      
-      def ReleaseSemaphore(handle, release_count, previous_count)
-         ReleaseSemaphore.call(handle, release_count, previous_count) != 0
-      end
-      
-      def ResetEvent(handle)
-         ResetEvent.call(handle) != 0
-      end
-      
-      def SetEvent(handle)
-         SetEvent.call(handle) != 0
-      end
-      
-      def WaitForMultipleObjects(count, handles, wait_all, milliseconds)
-         WaitForMultipleObjects.call(count, handles, wait_all, milliseconds)
-      end
-      
-      def WaitForMultipleObjectsEx(count, handles, wait_all, milliseconds, alertable)
-         WaitForMultipleObjectsEx.call(count, handles, wait_all, milliseconds, alertable)
-      end
-      
-      def WaitForSingleObject(handle, milliseconds)
-         WaitForSingleObject.call(handle, milliseconds)
-      end
-      
-      def WaitForSingleObjectEx(handle, milliseconds, alertable)
-         WaitForSingleObjectEx.call(handle, milliseconds, alertable)
-      end
+      API.new('CreateEvent', 'PIIP', 'L')
+      API.new('CreateMutex', 'PIP', 'L')
+      API.new('CreateSemaphore', 'PLLP', 'L')
+      API.new('GetOverlappedResult', 'LPPI', 'I')
+      API.new('MsgWaitForMultipleObjects', 'LPILL', 'L', 'user32')
+      API.new('MsgWaitForMultipleObjectsEx', 'LPLLL', 'L', 'user32')
+      API.new('OpenEvent', 'LIP', 'L')
+      API.new('OpenMutex', 'LIP', 'L')
+      API.new('OpenSemaphore', 'LIP', 'L')
+      API.new('ReleaseMutex', 'L', 'B')
+      API.new('ReleaseSemaphore', 'LLP', 'B')
+      API.new('ResetEvent', 'L', 'B')
+      API.new('SetEvent', 'L', 'B')
+      API.new('WaitForMultipleObjects', 'LPIL', 'L')
+      API.new('WaitForMultipleObjectsEx', 'LPILI', 'L')
+      API.new('WaitForSingleObject', 'LL', 'L')
+      API.new('WaitForSingleObjectEx', 'LLI', 'L')
    end
 end

data/lib/windows/system_info.rb

@@ -1,7 +1,13 @@
-require 'Win32API'
+require 'windows/api'
+include Windows
 
 module Windows
    module SystemInfo
+      API.auto_namespace = 'Windows::SystemInfo'
+      API.auto_constant  = true
+      API.auto_method    = true
+      API.auto_unicode   = true
+
       # Obsolete processor info constants
       PROCESSOR_INTEL_386     = 386
       PROCESSOR_INTEL_486     = 486
@@ -20,51 +26,14 @@ module Windows
       ComputerNamePhysicalDnsFullyQualified  = 7
       ComputerNameMax                        = 8
       
-      ExpandEnvironmentStrings = Win32API.new('kernel32', 'ExpandEnvironmentStrings', 'PPL', 'L')
-      
-      GetComputerName     = Win32API.new('kernel32', 'GetComputerName', 'PP', 'I')
-      GetComputerNameEx   = Win32API.new('kernel32', 'GetComputerNameEx', 'PPP', 'I')
-      GetSystemInfo       = Win32API.new('kernel32', 'GetSystemInfo', 'P', 'V')
-      GetUserName         = Win32API.new('advapi32', 'GetUserName', 'PP', 'I')
-      GetUserNameEx       = Win32API.new('secur32', 'GetUserNameEx', 'LPP', 'I')
-      GetVersion          = Win32API.new('kernel32', 'GetVersion', 'V', 'L')
-      GetVersionEx        = Win32API.new('kernel32', 'GetVersionEx', 'P', 'I')
-      GetWindowsDirectory = Win32API.new('kernel32', 'GetWindowsDirectory', 'LI', 'I')
-      
-      def ExpandEnvironmentStrings(src, dest, size)
-         ExpandEnvironmentStrings.call(src, dest, size)
-      end
-
-      def GetComputerName(buffer, size)
-         GetComputerName.call(buffer, size) != 0
-      end
-
-      def GetComputerNameEx(name, buffer, size)
-         GetComputerNameEx.call(name, buffer, size) != 0
-      end
-
-      def GetSystemInfo(info)
-         GetSystemInfo.call(info)
-      end
-
-      def GetUserName(buf, size)
-         GetUserName.call(buf, size) != 0
-      end
-
-      def GetUserNameEx(format, buf, size)
-         GetUserNameEx.call(format, buf, size) != 0
-      end
-
-      def GetVersion()
-         GetVersion.call
-      end
-
-      def GetVersionEx(info)
-         GetVersionEx.call(info) != 0
-      end
-
-      def GetWindowsDirectory(buf, size)
-         GetWindowsDirectory.call(buf, size)
-      end
+      API.new('ExpandEnvironmentStrings', 'PPL', 'L')
+      API.new('GetComputerName', 'PP', 'B')
+      API.new('GetComputerNameEx', 'PPP', 'B')
+      API.new('GetSystemInfo', 'P', 'V')
+      API.new('GetUserName', 'PP', 'B', 'advapi32')
+      API.new('GetUserNameEx', 'LPP', 'B', 'secur32')
+      API.new('GetVersion', 'V', 'L')
+      API.new('GetVersionEx', 'P', 'B')
+      API.new('GetWindowsDirectory', 'PI', 'I')
    end
 end

data/lib/windows/unicode.rb

@@ -1,7 +1,13 @@
-require 'Win32API'
+require 'windows/api'
+include Windows
 
 module Windows
    module Unicode
+      API.auto_namespace = 'Windows::Unicode'
+      API.auto_constant  = true
+      API.auto_method    = true
+      API.auto_unicode   = false
+
       CP_ACP         = 0
       CP_OEMCP       = 1
       CP_MACCP       = 2
@@ -62,49 +68,23 @@ module Windows
       TCI_SRCFONTSIG  = 3
       TCI_SRCLOCALE   = 0x100
 
-      GetTextCharset       = Win32API.new('gdi32', 'GetTextCharset', 'L', 'I')
-      GetTextCharsetInfo   = Win32API.new('gdi32', 'GetTextCharsetInfo', 'LPL', 'I')
-      IsDBCSLeadByte       = Win32API.new('kernel32', 'IsDBCSLeadByte', 'P', 'I')
-      IsDBCSLeadByteEx     = Win32API.new('kernel32', 'IsDBCSLeadByteEx', 'IP', 'I')
-      IsTextUnicode        = Win32API.new('advapi32', 'IsTextUnicode', 'PIP', 'I')
-      MultiByteToWideChar  = Win32API.new('kernel32', 'MultiByteToWideChar', 'ILPIPI', 'I')
-      TranslateCharsetInfo = Win32API.new('gdi32', 'TranslateCharsetInfo', 'PPL', 'I')
-      WideCharToMultiByte  = Win32API.new('kernel32', 'WideCharToMultiByte', 'ILPIPIPP', 'I')
-
-      def GetTextCharset(hdc)
-         GetTextCharset.call(hdc)
-      end
-
-      def GetTextCharsetInfo(hdc, sig, flags)
-         GetTextCharsetInfo.call(hdc, sig, flags)
-      end
-
-      def IsDBCSLeadByte(char)
-         IsDBCSLeadByte.call(char) != 0
-      end
-
-      def IsDBCSLeadByteEx(code_page, char)
-         IsDBCSLeadByteEx.call(code_pag, char) != 0
-      end
+      API.new('GetTextCharset', 'L', 'I', 'gdi32')
+      API.new('GetTextCharsetInfo', 'LPL', 'I', 'gdi32')
+      API.new('IsDBCSLeadByte', 'P', 'B')
+      API.new('IsDBCSLeadByteEx', 'IP', 'B')
+      API.new('IsTextUnicode', 'PIP', 'B', 'advapi32')
+      API.new('MultiByteToWideChar', 'ILPIPI', 'I')
+      API.new('TranslateCharsetInfo', 'PPL', 'B', 'gdi32')
+      API.new('WideCharToMultiByte', 'ILPIPIPP', 'I')
 
-      def IsTextUnicode(buf, size = buf.size, options = 0)
-         IsTextUnicode.call(buf, size, options) != 0
-      end
-
-      def MultiByteToWideChar(page, flags, str, str_size, buf, buf_size)
-         MultiByteToWideChar.call(page, flags, str, str_size, buf, buf_size)
-      end
-
-      def TranslateCharsetInfo(src, cs, flags)
-         TranslateCharsetInfo.call(src, cs, flags) != 0
-      end
-
-      def WideCharToMultiByte(page, flags, str, str_size, buf, buf_size, defchar, used_def)
-         WideCharToMultiByte.call(page, flags, str, str_size, buf, buf_size, defchar, used_def)
-      end
-      
       # Convenient wrapper methods
       
+      # Maps a wide character string to a new character string using the
+      # specified +encoding+.  If no encoding is specified, then CP_UTF8 
+      # iss used if $KCODE is set to UTF8. Otherwise, CP_ACP is used.
+      # 
+      # If the function fails it simply returns the string as-is.
+      # 
       # Maps a string to a wide (unicode) string using +encoding+. If no
       # encoding is specified, then CP_UTF8 is used if $KCODE is set to UTF8.
       # Otherwise, CP_ACP is used.