Class: Metasm::WinAPI

Inherits:

DynLdr

• Object
• DynLdr
• Metasm::WinAPI

Defined in:

lib/metasm/os/windows.rb

Constant Summary

SE_DEBUG_NAME =

'SeDebugPrivilege'

Constants inherited from DynLdr

DynLdr::DYNLDR_ASM_IA32, DynLdr::DYNLDR_ASM_X86_64, DynLdr::DYNLDR_C, DynLdr::DYNLDR_C_PE_HACK, DynLdr::RUBY_H

Class Method Summary

• .api_not_found(lib, func) ⇒ Object
• .convert_ret_c2rb(fproto, ret) ⇒ Object

  convert a native function return value if the native does not have the zero_not_fail attribute, convert 0 to nil, and print a message on stdout.

• .last_error_msg(errno = nil) ⇒ Object

  retrieve the textual error message relative to GetLastError.

Methods inherited from DynLdr

alloc_c_ary, alloc_c_ptr, alloc_c_struct, c_const_name_to_rb, c_func_name_to_rb, callback_alloc_c, callback_alloc_cobj, callback_find_id, callback_free, callback_run, compile_binary_module, compile_binary_module_hack, compile_c, const_missing, convert_c2rb, convert_cbargs_c2rb, convert_rb2c, cp, cp=, decode_c_ary, decode_c_struct, decode_c_value, encode_c_value, find_bin_path, find_write_dir, host_arch, host_cpu, host_exe, lib_from_sym, memory_read_strz, memory_read_wstrz, new_api_c, new_caller_for, new_func_asm, new_func_c, parse_c, start, trace_invoke

Class Method Details

.api_not_found(lib, func) ⇒ Object

# File 'lib/metasm/os/windows.rb', line 11

def self.api_not_found(lib, func)
	puts "could not find symbol #{func.name.inspect} in #{lib.inspect}" if $VERBOSE and not func.attributes.to_a.include?('optional')
end

.convert_ret_c2rb(fproto, ret) ⇒ Object

convert a native function return value if the native does not have the zero_not_fail attribute, convert 0 to nil, and print a message on stdout

# File 'lib/metasm/os/windows.rb', line 1173

def self.convert_ret_c2rb(fproto, ret)
	@last_err_msg = nil
	if ret == 0 and not fproto.has_attribute 'zero_not_fail'
		# save error msg so that last_error_msg returns the same thing if called again
		puts "WinAPI: error in #{fproto.name}: #{@last_err_msg = last_error_msg}" if $VERBOSE
		nil
	else super(fproto, ret)
	end
end

.last_error_msg(errno = nil) ⇒ Object

retrieve the textual error message relative to GetLastError

# File 'lib/metasm/os/windows.rb', line 1184

def self.last_error_msg(errno = nil)
	return @last_err_msg if @last_err_msg
	errno ||= getlasterror
	message = ' '*512
	if formatmessagea(FORMAT_MESSAGE_FROM_SYSTEM, nil, errno, 0, message, message.length, nil) == 0
		message = 'unknown error %x' % errno
	else
		message = message[0, message.index(?\0)] if message.index(?\0)
		message.chomp!
	end
	message
end