win32-process 0.8.3 → 0.9.0

data/lib/win32/process/constants.rb

@@ -1,121 +1,121 @@
-require 'ffi'
-
-module Process::Constants
-  include FFI::Library
-
-  private
-
-  # Priority constants
-
-  ABOVE_NORMAL_PRIORITY_CLASS = 0x0008000
-  BELOW_NORMAL_PRIORITY_CLASS = 0x0004000
-  HIGH_PRIORITY_CLASS         = 0x0000080
-  IDLE_PRIORITY_CLASS         = 0x0000040
-  NORMAL_PRIORITY_CLASS       = 0x0000020
-  REALTIME_PRIORITY_CLASS     = 0x0000010
-
-  # Error constants
-
-  INVALID_HANDLE_VALUE = FFI::Pointer.new(-1).address
-  ERROR_ACCESS_DENIED  = 0x00000005
-
-  # Process Access Rights
-
-  PROCESS_TERMINATE         = 0x00000001
-  PROCESS_SET_INFORMATION   = 0x00000200
-  PROCESS_QUERY_INFORMATION = 0x00000400
-  PROCESS_ALL_ACCESS        = 0x001F0FFF
-  PROCESS_VM_READ           = 0x00000010
-
-  # Process wait time for Process.kill
-
-  INFINITE = 0xFFFFFFFF
-
-  # Process creation flags
-
-  CREATE_BREAKAWAY_FROM_JOB        = 0x01000000
-  CREATE_DEFAULT_ERROR_MODE        = 0x04000000
-  CREATE_NEW_CONSOLE               = 0x00000010
-  CREATE_NEW_PROCESS_GROUP         = 0x00000200
-  CREATE_NO_WINDOW                 = 0x08000000
-  CREATE_PROTECTED_PROCESS         = 0x00040000
-  CREATE_PRESERVE_CODE_AUTHZ_LEVEL = 0x02000000
-  CREATE_SEPARATE_WOW_VDM          = 0x00000800
-  CREATE_SHARED_WOW_VDM            = 0x00001000
-  CREATE_SUSPENDED                 = 0x00000004
-  CREATE_UNICODE_ENVIRONMENT       = 0x00000400
-  DEBUG_ONLY_THIS_PROCESS          = 0x00000002
-  DEBUG_PROCESS                    = 0x00000001
-  DETACHED_PROCESS                 = 0x00000008
-  INHERIT_PARENT_AFFINITY          = 0x00010000
-
-  STARTF_USESHOWWINDOW    = 0x00000001
-  STARTF_USESIZE          = 0x00000002
-  STARTF_USEPOSITION      = 0x00000004
-  STARTF_USECOUNTCHARS    = 0x00000008
-  STARTF_USEFILLATTRIBUTE = 0x00000010
-  STARTF_RUNFULLSCREEN    = 0x00000020
-  STARTF_FORCEONFEEDBACK  = 0x00000040
-  STARTF_FORCEOFFFEEDBACK = 0x00000080
-  STARTF_USESTDHANDLES    = 0x00000100
-  STARTF_USEHOTKEY        = 0x00000200
-  STARTF_TITLEISLINKNAME  = 0x00000800
-  STARTF_TITLEISAPPID     = 0x00001000
-  STARTF_PREVENTPINNING   = 0x00002000
-
-  LOGON_WITH_PROFILE        = 0x00000001
-  LOGON_NETCREDENTIALS_ONLY = 0x00000002
-
-  SHUTDOWN_NORETRY = 0x00000001
-
-  # Security
-
-  TokenUser   = 1
-  TOKEN_QUERY = 0x00000008
-
-  # Define these for Windows. They are not actually used but are defined
-  # for interface compatibility.
-
-  PRIO_PROCESS = 0
-  PRIO_PGRP    = 1
-  PRIO_USER    = 2
-
-  # Define these for Windows
-
-  RLIMIT_CPU    = 0 # PerProcessUserTimeLimit
-  RLIMIT_FSIZE  = 1 # Hard coded at 4TB - 64K (assumes NTFS)
-  RLIMIT_AS     = 5 # ProcessMemoryLimit
-  RLIMIT_RSS    = 5 # ProcessMemoryLimit
-  RLIMIT_VMEM   = 5 # ProcessMemoryLimit
-
-  # Job constants
-
-  JOB_OBJECT_SET_ATTRIBUTES       = 0x00000002
-  JOB_OBJECT_QUERY                = 0x00000004
-  JOB_OBJECT_LIMIT_PROCESS_TIME   = 0x00000002
-  JOB_OBJECT_LIMIT_PROCESS_MEMORY = 0x00000100
-  JobObjectExtendedLimitInformation = 9
-
-  # Console Events
-
-  CTRL_C_EVENT     = 0
-  CTRL_BREAK_EVENT = 1
-
-  # Miscellaneous
-
-  HANDLE_FLAG_INHERIT     = 0x00000001
-  SEM_FAILCRITICALERRORS  = 0x00000001
-  SEM_NOGPFAULTERRORBOX   = 0x00000002
-
-  # GetExitCodeProcess
-
-  STILL_ACTIVE = 259
-
-  # Snapshot constants
-
-  TH32CS_SNAPHEAPLIST = 0x00000001
-  TH32CS_SNAPPROCESS  = 0x00000002
-  TH32CS_SNAPTHREAD   = 0x00000004
-  TH32CS_SNAPMODULE   = 0x00000008
-  ERROR_NO_MORE_FILES = 0x00000018
-end
+require 'ffi'
+
+module Process::Constants
+  include FFI::Library
+
+  private
+
+  # Priority constants
+
+  ABOVE_NORMAL_PRIORITY_CLASS = 0x0008000
+  BELOW_NORMAL_PRIORITY_CLASS = 0x0004000
+  HIGH_PRIORITY_CLASS         = 0x0000080
+  IDLE_PRIORITY_CLASS         = 0x0000040
+  NORMAL_PRIORITY_CLASS       = 0x0000020
+  REALTIME_PRIORITY_CLASS     = 0x0000010
+
+  # Error constants
+
+  INVALID_HANDLE_VALUE = FFI::Pointer.new(-1).address
+  ERROR_ACCESS_DENIED  = 0x00000005
+
+  # Process Access Rights
+
+  PROCESS_TERMINATE         = 0x00000001
+  PROCESS_SET_INFORMATION   = 0x00000200
+  PROCESS_QUERY_INFORMATION = 0x00000400
+  PROCESS_ALL_ACCESS        = 0x001F0FFF
+  PROCESS_VM_READ           = 0x00000010
+
+  # Process wait time for Process.kill
+
+  INFINITE = 0xFFFFFFFF
+
+  # Process creation flags
+
+  CREATE_BREAKAWAY_FROM_JOB        = 0x01000000
+  CREATE_DEFAULT_ERROR_MODE        = 0x04000000
+  CREATE_NEW_CONSOLE               = 0x00000010
+  CREATE_NEW_PROCESS_GROUP         = 0x00000200
+  CREATE_NO_WINDOW                 = 0x08000000
+  CREATE_PROTECTED_PROCESS         = 0x00040000
+  CREATE_PRESERVE_CODE_AUTHZ_LEVEL = 0x02000000
+  CREATE_SEPARATE_WOW_VDM          = 0x00000800
+  CREATE_SHARED_WOW_VDM            = 0x00001000
+  CREATE_SUSPENDED                 = 0x00000004
+  CREATE_UNICODE_ENVIRONMENT       = 0x00000400
+  DEBUG_ONLY_THIS_PROCESS          = 0x00000002
+  DEBUG_PROCESS                    = 0x00000001
+  DETACHED_PROCESS                 = 0x00000008
+  INHERIT_PARENT_AFFINITY          = 0x00010000
+
+  STARTF_USESHOWWINDOW    = 0x00000001
+  STARTF_USESIZE          = 0x00000002
+  STARTF_USEPOSITION      = 0x00000004
+  STARTF_USECOUNTCHARS    = 0x00000008
+  STARTF_USEFILLATTRIBUTE = 0x00000010
+  STARTF_RUNFULLSCREEN    = 0x00000020
+  STARTF_FORCEONFEEDBACK  = 0x00000040
+  STARTF_FORCEOFFFEEDBACK = 0x00000080
+  STARTF_USESTDHANDLES    = 0x00000100
+  STARTF_USEHOTKEY        = 0x00000200
+  STARTF_TITLEISLINKNAME  = 0x00000800
+  STARTF_TITLEISAPPID     = 0x00001000
+  STARTF_PREVENTPINNING   = 0x00002000
+
+  LOGON_WITH_PROFILE        = 0x00000001
+  LOGON_NETCREDENTIALS_ONLY = 0x00000002
+
+  SHUTDOWN_NORETRY = 0x00000001
+
+  # Security
+
+  TokenUser   = 1
+  TOKEN_QUERY = 0x00000008
+
+  # Define these for Windows. They are not actually used but are defined
+  # for interface compatibility.
+
+  PRIO_PROCESS = 0
+  PRIO_PGRP    = 1
+  PRIO_USER    = 2
+
+  # Define these for Windows
+
+  RLIMIT_CPU    = 0 # PerProcessUserTimeLimit
+  RLIMIT_FSIZE  = 1 # Hard coded at 4TB - 64K (assumes NTFS)
+  RLIMIT_AS     = 5 # ProcessMemoryLimit
+  RLIMIT_RSS    = 5 # ProcessMemoryLimit
+  RLIMIT_VMEM   = 5 # ProcessMemoryLimit
+
+  # Job constants
+
+  JOB_OBJECT_SET_ATTRIBUTES       = 0x00000002
+  JOB_OBJECT_QUERY                = 0x00000004
+  JOB_OBJECT_LIMIT_PROCESS_TIME   = 0x00000002
+  JOB_OBJECT_LIMIT_PROCESS_MEMORY = 0x00000100
+  JobObjectExtendedLimitInformation = 9
+
+  # Console Events
+
+  CTRL_C_EVENT     = 0
+  CTRL_BREAK_EVENT = 1
+
+  # Miscellaneous
+
+  HANDLE_FLAG_INHERIT     = 0x00000001
+  SEM_FAILCRITICALERRORS  = 0x00000001
+  SEM_NOGPFAULTERRORBOX   = 0x00000002
+
+  # GetExitCodeProcess
+
+  STILL_ACTIVE = 259
+
+  # Snapshot constants
+
+  TH32CS_SNAPHEAPLIST = 0x00000001
+  TH32CS_SNAPPROCESS  = 0x00000002
+  TH32CS_SNAPTHREAD   = 0x00000004
+  TH32CS_SNAPMODULE   = 0x00000008
+  ERROR_NO_MORE_FILES = 0x00000018
+end

data/lib/win32/process/functions.rb

@@ -1,91 +1,91 @@
-if RUBY_PLATFORM == 'java'
-  require 'rubygems'
-  gem 'ffi'
-end
-
-require 'ffi'
-
-module Process::Functions
-  module FFI::Library
-    unless instance_methods.include?(:attach_pfunc)
-      # Wrapper method for attach_function + private
-      def attach_pfunc(*args)
-        attach_function(*args)
-        private args[0]
-      end
-    end
-  end
-
-  extend FFI::Library
-
-  typedef :ulong, :dword
-  typedef :uintptr_t, :handle
-  typedef :uintptr_t, :hwnd
-  typedef :uintptr_t, :hmodule
-
-  ffi_lib :kernel32
-
-  attach_pfunc :CloseHandle, [:handle], :bool
-  attach_pfunc :CreateToolhelp32Snapshot, [:dword, :dword], :handle
-  attach_pfunc :GenerateConsoleCtrlEvent, [:dword, :dword], :bool
-  attach_pfunc :GetCurrentProcess, [], :handle
-  attach_pfunc :GetModuleHandle, :GetModuleHandleA, [:string], :hmodule
-  attach_pfunc :GetProcessAffinityMask, [:handle, :pointer, :pointer], :bool
-  attach_pfunc :GetPriorityClass, [:handle], :dword
-  attach_pfunc :GetProcAddress, [:hmodule, :string], :pointer
-  attach_pfunc :GetVersionExA, [:pointer], :bool
-  attach_pfunc :Heap32ListFirst, [:handle, :pointer], :bool
-  attach_pfunc :Heap32ListNext, [:handle, :pointer], :bool
-  attach_pfunc :Heap32First, [:pointer, :dword, :uintptr_t], :bool
-  attach_pfunc :Heap32Next, [:pointer], :bool
-  attach_pfunc :Module32First, [:handle, :pointer], :bool
-  attach_pfunc :Module32Next, [:handle, :pointer], :bool
-  attach_pfunc :IsProcessInJob, [:handle, :pointer, :pointer], :bool # 2nd arg optional
-  attach_pfunc :OpenProcess, [:dword, :int, :dword], :handle
-  attach_pfunc :Process32First, [:handle, :pointer], :bool
-  attach_pfunc :Process32Next, [:handle, :pointer], :bool
-  attach_pfunc :SetHandleInformation, [:handle, :dword, :dword], :bool
-  attach_pfunc :SetErrorMode, [:uint], :uint
-  attach_pfunc :SetPriorityClass, [:handle, :dword], :bool
-  attach_pfunc :TerminateProcess, [:handle, :uint], :bool
-  attach_pfunc :Thread32First, [:handle, :pointer], :bool
-  attach_pfunc :Thread32Next, [:handle, :pointer], :bool
-  attach_pfunc :WaitForSingleObject, [:handle, :dword], :dword
-
-  attach_pfunc :CreateRemoteThread,
-    [:handle, :pointer, :size_t, :pointer, :pointer, :dword, :pointer], :handle
-
-  attach_pfunc :GetVolumeInformationA,
-    [:string, :pointer, :dword, :pointer, :pointer, :pointer, :pointer, :dword], :bool
-
-  attach_pfunc :CreateProcessW,
-    [:buffer_in, :buffer_inout, :pointer, :pointer, :int,
-     :dword, :buffer_in, :buffer_in, :pointer, :pointer], :bool
-
-  attach_pfunc :AssignProcessToJobObject, [:handle, :handle], :bool
-  attach_pfunc :CreateJobObjectA, [:pointer, :string], :handle
-  attach_pfunc :OpenJobObjectA, [:dword, :int, :string], :handle
-  attach_pfunc :QueryInformationJobObject, [:handle, :int, :pointer, :dword, :pointer], :bool
-  attach_pfunc :SetInformationJobObject, [:handle, :int, :pointer, :dword], :bool
-  attach_pfunc :GetExitCodeProcess, [:handle, :pointer], :bool
-
-  ffi_lib :advapi32
-
-  attach_pfunc :ConvertSidToStringSidA, [:buffer_in, :pointer], :bool
-  attach_pfunc :GetTokenInformation, [:handle, :int, :pointer, :dword, :pointer], :bool
-  attach_pfunc :OpenProcessToken, [:handle, :dword, :pointer], :bool
-
-  attach_pfunc :CreateProcessWithLogonW,
-    [:buffer_in, :buffer_in, :buffer_in, :dword, :buffer_in, :buffer_inout,
-     :dword, :buffer_in, :buffer_in, :pointer, :pointer], :bool
-
-  ffi_lib FFI::Library::LIBC
-
-  attach_pfunc :get_osfhandle, :_get_osfhandle, [:int], :intptr_t
-
-  begin
-    attach_pfunc :get_errno, :_get_errno, [:pointer], :int
-  rescue FFI::NotFoundError
-    # Do nothing, Windows XP or earlier.
-  end
-end
+if RUBY_PLATFORM == 'java'
+  require 'rubygems'
+  gem 'ffi'
+end
+
+require 'ffi'
+
+module Process::Functions
+  module FFI::Library
+    unless instance_methods.include?(:attach_pfunc)
+      # Wrapper method for attach_function + private
+      def attach_pfunc(*args)
+        attach_function(*args)
+        private args[0]
+      end
+    end
+  end
+
+  extend FFI::Library
+
+  typedef :ulong, :dword
+  typedef :uintptr_t, :handle
+  typedef :uintptr_t, :hwnd
+  typedef :uintptr_t, :hmodule
+
+  ffi_lib :kernel32
+
+  attach_pfunc :CloseHandle, [:handle], :bool
+  attach_pfunc :CreateToolhelp32Snapshot, [:dword, :dword], :handle
+  attach_pfunc :GenerateConsoleCtrlEvent, [:dword, :dword], :bool
+  attach_pfunc :GetCurrentProcess, [], :handle
+  attach_pfunc :GetModuleHandle, :GetModuleHandleA, [:string], :hmodule
+  attach_pfunc :GetProcessAffinityMask, [:handle, :pointer, :pointer], :bool
+  attach_pfunc :GetPriorityClass, [:handle], :dword
+  attach_pfunc :GetProcAddress, [:hmodule, :string], :pointer
+  attach_pfunc :GetVersionExA, [:pointer], :bool
+  attach_pfunc :Heap32ListFirst, [:handle, :pointer], :bool
+  attach_pfunc :Heap32ListNext, [:handle, :pointer], :bool
+  attach_pfunc :Heap32First, [:pointer, :dword, :uintptr_t], :bool
+  attach_pfunc :Heap32Next, [:pointer], :bool
+  attach_pfunc :Module32First, [:handle, :pointer], :bool
+  attach_pfunc :Module32Next, [:handle, :pointer], :bool
+  attach_pfunc :IsProcessInJob, [:handle, :pointer, :pointer], :bool # 2nd arg optional
+  attach_pfunc :OpenProcess, [:dword, :int, :dword], :handle
+  attach_pfunc :Process32First, [:handle, :pointer], :bool
+  attach_pfunc :Process32Next, [:handle, :pointer], :bool
+  attach_pfunc :SetHandleInformation, [:handle, :dword, :dword], :bool
+  attach_pfunc :SetErrorMode, [:uint], :uint
+  attach_pfunc :SetPriorityClass, [:handle, :dword], :bool
+  attach_pfunc :TerminateProcess, [:handle, :uint], :bool
+  attach_pfunc :Thread32First, [:handle, :pointer], :bool
+  attach_pfunc :Thread32Next, [:handle, :pointer], :bool
+  attach_pfunc :WaitForSingleObject, [:handle, :dword], :dword
+
+  attach_pfunc :CreateRemoteThread,
+    [:handle, :pointer, :size_t, :pointer, :pointer, :dword, :pointer], :handle
+
+  attach_pfunc :GetVolumeInformationA,
+    [:string, :pointer, :dword, :pointer, :pointer, :pointer, :pointer, :dword], :bool
+
+  attach_pfunc :CreateProcessW,
+    [:buffer_in, :buffer_inout, :pointer, :pointer, :int,
+     :dword, :buffer_in, :buffer_in, :pointer, :pointer], :bool
+
+  attach_pfunc :AssignProcessToJobObject, [:handle, :handle], :bool
+  attach_pfunc :CreateJobObjectA, [:pointer, :string], :handle
+  attach_pfunc :OpenJobObjectA, [:dword, :int, :string], :handle
+  attach_pfunc :QueryInformationJobObject, [:handle, :int, :pointer, :dword, :pointer], :bool
+  attach_pfunc :SetInformationJobObject, [:handle, :int, :pointer, :dword], :bool
+  attach_pfunc :GetExitCodeProcess, [:handle, :pointer], :bool
+
+  ffi_lib :advapi32
+
+  attach_pfunc :ConvertSidToStringSidA, [:buffer_in, :pointer], :bool
+  attach_pfunc :GetTokenInformation, [:handle, :int, :pointer, :dword, :pointer], :bool
+  attach_pfunc :OpenProcessToken, [:handle, :dword, :pointer], :bool
+
+  attach_pfunc :CreateProcessWithLogonW,
+    [:buffer_in, :buffer_in, :buffer_in, :dword, :buffer_in, :buffer_inout,
+     :dword, :buffer_in, :buffer_in, :pointer, :pointer], :bool
+
+  ffi_lib FFI::Library::LIBC
+
+  attach_pfunc :get_osfhandle, :_get_osfhandle, [:int], :intptr_t
+
+  begin
+    attach_pfunc :get_errno, :_get_errno, [:pointer], :int
+  rescue FFI::NotFoundError
+    # Do nothing, Windows XP or earlier.
+  end
+end

data/lib/win32/process/helper.rb

@@ -1,13 +1,13 @@
-class String
-  # Convert a regular string to a wide character string. This does not
-  # modify the receiver.
-  def to_wide_string
-    (self + 0.chr).encode('UTF-16LE')
-  end
-
-  # Convert a regular string to a wide character string. This modifies
-  # the receiver.
-  def to_wide_string!
-    replace((self + 0.chr).encode('UTF-16LE'))
-  end
+class String
+  # Convert a regular string to a wide character string. This does not
+  # modify the receiver.
+  def to_wide_string
+    (self + 0.chr).encode('UTF-16LE')
+  end
+
+  # Convert a regular string to a wide character string. This modifies
+  # the receiver.
+  def to_wide_string!
+    replace((self + 0.chr).encode('UTF-16LE'))
+  end
 end