Class: ReservedNames::Win32::Process

Inherits:
Object
  • Object
show all
Extended by:
Chef::ReservedNames::Win32::API::PSAPI, Chef::ReservedNames::Win32::API::Process
Includes:
Chef::ReservedNames::Win32::API::PSAPI, Chef::ReservedNames::Win32::API::Process
Defined in:
lib/chef/win32/process.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(handle) ⇒ Process

Returns a new instance of Process


33
34
35
# File 'lib/chef/win32/process.rb', line 33

def initialize(handle)
  @handle = handle
end

Instance Attribute Details

#handleObject (readonly)

Returns the value of attribute handle


37
38
39
# File 'lib/chef/win32/process.rb', line 37

def handle
  @handle
end

Class Method Details

.get_current_processObject


51
52
53
# File 'lib/chef/win32/process.rb', line 51

def self.get_current_process
  Process.new(Handle.new(GetCurrentProcess()))
end

.get_process_handle_count(handle) ⇒ Object


55
56
57
58
59
60
61
# File 'lib/chef/win32/process.rb', line 55

def self.get_process_handle_count(handle)
  handle_count = FFI::MemoryPointer.new :uint32
  unless GetProcessHandleCount(handle.handle, handle_count)
    Chef::ReservedNames::Win32::Error.raise!
  end
  handle_count.read_uint32
end

.get_process_id(handle) ⇒ Object


63
64
65
66
67
68
69
70
# File 'lib/chef/win32/process.rb', line 63

def self.get_process_id(handle)
  # Must have PROCESS_QUERY_INFORMATION or PROCESS_QUERY_LIMITED_INFORMATION rights
  result = GetProcessId(handle.handle)
  if result == 0
    Chef::ReservedNames::Win32::Error.raise!
  end
  result
end

.get_process_memory_info(handle) ⇒ Object

Must have PROCESS_QUERY_INFORMATION or PROCESS_QUERY_LIMITED_INFORMATION rights, AND the PROCESS_VM_READ right


87
88
89
90
91
92
93
# File 'lib/chef/win32/process.rb', line 87

def self.get_process_memory_info(handle)
  memory_info = PROCESS_MEMORY_COUNTERS.new
  unless GetProcessMemoryInfo(handle.handle, memory_info, memory_info.size)
    Chef::ReservedNames::Win32::Error.raise!
  end
  memory_info
end

.is_wow64_processObject


72
73
74
75
76
77
78
79
80
81
82
83
# File 'lib/chef/win32/process.rb', line 72

def self.is_wow64_process
  is_64_bit_process_result = FFI::MemoryPointer.new(:int)

  # The return value of IsWow64Process is nonzero value if the API call succeeds.
  # The result data are returned in the last parameter, not the return value.
  call_succeeded = IsWow64Process(GetCurrentProcess(), is_64_bit_process_result)

  # The result is nonzero if IsWow64Process's calling process, in the case here
  # this process, is running under WOW64, i.e. the result is nonzero if this
  # process is 32-bit (aka :i386).
  (call_succeeded != 0) && (is_64_bit_process_result.get_int(0) != 0)
end

Instance Method Details

#handle_countObject


43
44
45
# File 'lib/chef/win32/process.rb', line 43

def handle_count
  Process.get_process_handle_count(handle)
end

#idObject


39
40
41
# File 'lib/chef/win32/process.rb', line 39

def id
  Process.get_process_id(handle)
end

#memory_infoObject


47
48
49
# File 'lib/chef/win32/process.rb', line 47

def memory_info
  Process.get_process_memory_info(handle)
end