Module: Windows::Error

Defined in:
lib/windows/error.rb

Constant Summary collapse

FORMAT_MESSAGE_ALLOCATE_BUFFER = 
0x00000100
FORMAT_MESSAGE_IGNORE_INSERTS = 
0x00000200
FORMAT_MESSAGE_FROM_STRING = 
0x00000400
FORMAT_MESSAGE_FROM_HMODULE = 
0x00000800
FORMAT_MESSAGE_FROM_SYSTEM = 
0x00001000
FORMAT_MESSAGE_ARGUMENT_ARRAY = 
0x00002000
FORMAT_MESSAGE_MAX_WIDTH_MASK = 
0x000000FF
SEM_FAILCRITICALERRORS = 
0x0001
SEM_NOALIGNMENTFAULTEXCEPT = 
0x0004
SEM_NOGPFAULTERRORBOX = 
0x0002
SEM_NOOPENFILEERRORBOX = 
0x8000
NO_ERROR = 
0
ERROR_SUCCESS = 
0
ERROR_INVALID_FUNCTION = 
1
ERROR_FILE_NOT_FOUND = 
2
ERROR_PATH_NOT_FOUND = 
3
ERROR_TOO_MANY_OPEN_FILES = 
4
ERROR_ACCESS_DENIED = 
5
ERROR_INVALID_HANDLE = 
6
ERROR_ARENA_TRASHED = 
7
ERROR_NOT_ENOUGH_MEMORY = 
8
ERROR_INVALID_BLOCK = 
9
ERROR_BAD_ENVIRONMENT = 
10
ERROR_BAD_FORMAT = 
11
ERROR_INVALID_ACCESS = 
12
ERROR_INVALID_DATA = 
13
ERROR_INVALID_DRIVE = 
15
ERROR_CURRENT_DIRECTORY = 
16
ERROR_NOT_SAME_DEVICE = 
17
ERROR_NO_MORE_FILES = 
18
ERROR_WRITE_PROTECT = 
19
ERROR_BAD_UNIT = 
20
ERROR_NOT_READY = 
21
ERROR_BAD_COMMAND = 
22
ERROR_CRC = 
23
ERROR_BAD_LENGTH = 
24
ERROR_SEEK = 
25
ERROR_NOT_DOS_DISK = 
26
ERROR_SECTOR_NOT_FOUND = 
27
ERROR_OUT_OF_PAPER = 
28
ERROR_WRITE_FAULT = 
29
ERROR_READ_FAULT = 
30
ERROR_GEN_FAILURE = 
31
ERROR_SHARING_VIOLATION = 
32
ERROR_LOCK_VIOLATION = 
33
ERROR_WRONG_DISK = 
34
ERROR_FCB_UNAVAILABLE = 
35
ERROR_SHARING_BUFFER_EXCEEDED = 
36
ERROR_NOT_SUPPORTED = 
50
ERROR_FILE_EXISTS = 
80
ERROR_DUP_FCB = 
81
ERROR_CANNOT_MAKE = 
82
ERROR_FAIL_I24 = 
83
ERROR_OUT_OF_STRUCTURES = 
84
ERROR_ALREADY_ASSIGNED = 
85
ERROR_INVALID_PASSWORD = 
86
ERROR_INVALID_PARAMETER = 
87
ERROR_NET_WRITE_FAULT = 
88
ERROR_NO_PROC_SLOTS =

no process slots available

89
ERROR_NOT_FROZEN = 
90
ERR_TSTOVFL =

timer service table overflow

91
ERR_TSTDUP =

timer service table duplicate

92
ERROR_NO_ITEMS =

There were no items to operate upon

93
ERROR_INTERRUPT =

interrupted system call

95
ERROR_TOO_MANY_SEMAPHORES = 
100
ERROR_EXCL_SEM_ALREADY_OWNED = 
101
ERROR_SEM_IS_SET = 
102
ERROR_TOO_MANY_SEM_REQUESTS = 
103
ERROR_INVALID_AT_INTERRUPT_TIME = 
104
ERROR_SEM_OWNER_DIED =

waitsem found owner died

105
ERROR_SEM_USER_LIMIT =

too many procs have this sem

106
ERROR_DISK_CHANGE =

insert disk b into drive a

107
ERROR_DRIVE_LOCKED =

drive locked by another process

108
ERROR_BROKEN_PIPE =

write on pipe with no reader

109
ERROR_OPEN_FAILED =

open/created failed

110
ERROR_DISK_FULL =

not enough space

112
ERROR_NO_MORE_SEARCH_HANDLES =

can’t allocate

113
ERROR_INVALID_TARGET_HANDLE =

handle in DOSDUPHANDLE is invalid

114
ERROR_PROTECTION_VIOLATION =

bad user virtual address

115
ERROR_VIOKBD_REQUEST = 
116
ERROR_INVALID_CATEGORY =

category for DEVIOCTL not defined

117
ERROR_INVALID_VERIFY_SWITCH =

invalid value

118
ERROR_BAD_DRIVER_LEVEL =

DosDevIOCTL not level four

119
ERROR_CALL_NOT_IMPLEMENTED = 
120
ERROR_SEM_TIMEOUT =

timeout from semaphore function

121
ERROR_INSUFFICIENT_BUFFER = 
122
ERROR_INVALID_NAME =

illegal char or malformed file system name

123
ERROR_INVALID_LEVEL =

unimplemented level for info retrieval

124
ERROR_NO_VOLUME_LABEL =

no volume label found

125
ERROR_MOD_NOT_FOUND =

w_getprocaddr, w_getmodhandle

126
ERROR_PROC_NOT_FOUND =

w_getprocaddr

127
ERROR_WAIT_NO_CHILDREN =

CWait finds to children

128
ERROR_CHILD_NOT_COMPLETE =

CWait children not dead yet

129
ERROR_DIRECT_ACCESS_HANDLE =

invalid for direct disk access

130
ERROR_NEGATIVE_SEEK =

tried to seek negative offset

131
ERROR_SEEK_ON_DEVICE =

tried to seek on device or pipe

132
ERROR_IS_JOIN_TARGET = 
133
ERROR_IS_JOINED = 
134
ERROR_IS_SUBSTED = 
135
ERROR_NOT_JOINED = 
136
ERROR_NOT_SUBSTED = 
137
ERROR_JOIN_TO_JOIN = 
138
ERROR_SUBST_TO_SUBST = 
139
ERROR_JOIN_TO_SUBST = 
140
ERROR_SUBST_TO_JOIN = 
141
ERROR_BUSY_DRIVE = 
142
ERROR_SAME_DRIVE = 
143
ERROR_DIR_NOT_ROOT = 
144
ERROR_DIR_NOT_EMPTY = 
145
ERROR_IS_SUBST_PATH = 
146
ERROR_IS_JOIN_PATH = 
147
ERROR_PATH_BUSY = 
148
ERROR_IS_SUBST_TARGET = 
149
ERROR_SYSTEM_TRACE =

system trace error

150
ERROR_INVALID_EVENT_COUNT =

DosMuxSemWait errors

151
ERROR_TOO_MANY_MUXWAITERS = 
152
ERROR_INVALID_LIST_FORMAT = 
153
ERROR_LABEL_TOO_LONG = 
154
ERROR_TOO_MANY_TCBS = 
155
ERROR_SIGNAL_REFUSED = 
156
ERROR_DISCARDED = 
157
ERROR_NOT_LOCKED = 
158
ERROR_BAD_THREADID_ADDR = 
159
ERROR_BAD_ARGUMENTS = 
160
ERROR_BAD_PATHNAME = 
161
ERROR_SIGNAL_PENDING = 
162
ERROR_UNCERTAIN_MEDIA = 
163
ERROR_MAX_THRDS_REACHED = 
164
ERROR_MONITORS_NOT_SUPPORTED = 
165
ERROR_INVALID_SEGMENT_NUMBER = 
180
ERROR_INVALID_CALLGATE = 
181
ERROR_INVALID_ORDINAL = 
182
ERROR_ALREADY_EXISTS = 
183
ERROR_NO_CHILD_PROCESS = 
184
ERROR_CHILD_ALIVE_NOWAIT = 
185
ERROR_INVALID_FLAG_NUMBER = 
186
ERROR_SEM_NOT_FOUND = 
187
ERROR_INVALID_STARTING_CODESEG = 
188
ERROR_INVALID_STACKSEG = 
189
ERROR_INVALID_MODULETYPE = 
190
ERROR_INVALID_EXE_SIGNATURE = 
191
ERROR_EXE_MARKED_INVALID = 
192
ERROR_BAD_EXE_FORMAT = 
193
ERROR_ITERATED_DATA_EXCEEDS_64k = 
194
ERROR_INVALID_MINALLOCSIZE = 
195

196
ERROR_IOPL_NOT_ENABLED = 
197
ERROR_INVALID_SEGDPL = 
198
ERROR_AUTODATASEG_EXCEEDS_64k = 
199
ERROR_RING2SEG_MUST_BE_MOVABLE = 
200
ERROR_RELOC_CHAIN_XEEDS_SEGLIM = 
201
ERROR_INFLOOP_IN_RELOC_CHAIN = 
202
ERROR_ENVVAR_NOT_FOUND = 
203
ERROR_NOT_CURRENT_CTRY = 
204
ERROR_NO_SIGNAL_SENT = 
205
ERROR_FILENAME_EXCED_RANGE =

if filename > 8.3

206
ERROR_RING2_STACK_IN_USE =

for FAPI

207
ERROR_META_EXPANSION_TOO_LONG =

if “*a” > 8.3

208
ERROR_INVALID_SIGNAL_NUMBER = 
209
ERROR_THREAD_1_INACTIVE = 
210
ERROR_INFO_NOT_AVAIL =

@@ PTM 5550

211
ERROR_LOCKED = 
212

213
ERROR_TOO_MANY_MODULES = 
214
ERROR_NESTING_NOT_ALLOWED = 
215
ERROR_MORE_DATA = 
234
ERROR_USER_DEFINED_BASE = 
0xF000
ERROR_I24_WRITE_PROTECT = 
0
ERROR_I24_BAD_UNIT = 
1
ERROR_I24_NOT_READY = 
2
ERROR_I24_BAD_COMMAND = 
3
ERROR_I24_CRC = 
4
ERROR_I24_BAD_LENGTH = 
5
ERROR_I24_SEEK = 
6
ERROR_I24_NOT_DOS_DISK = 
7
ERROR_I24_SECTOR_NOT_FOUND = 
8
ERROR_I24_OUT_OF_PAPER = 
9
ERROR_I24_WRITE_FAULT = 
0x0A
ERROR_I24_READ_FAULT = 
0x0B
ERROR_I24_GEN_FAILURE = 
0x0C
ERROR_I24_DISK_CHANGE = 
0x0D
ERROR_I24_WRONG_DISK = 
0x0F
ERROR_I24_UNCERTAIN_MEDIA = 
0x10
ERROR_I24_CHAR_CALL_INTERRUPTED = 
0x11
ERROR_I24_NO_MONITOR_SUPPORT = 
0x12
ERROR_I24_INVALID_PARAMETER = 
0x13
ALLOWED_FAIL = 
0x0001
ALLOWED_ABORT = 
0x0002
ALLOWED_RETRY = 
0x0004
ALLOWED_IGNORE = 
0x0008
I24_OPERATION = 
0x1
I24_AREA = 
0x6
I24_CLASS = 
0x80
ERRCLASS_OUTRES =

Out of Resource

1
ERRCLASS_TEMPSIT =

Temporary Situation

2
ERRCLASS_AUTH =

Permission problem

3
ERRCLASS_INTRN =

Internal System Error

4
ERRCLASS_HRDFAIL =

Hardware Failure

5
ERRCLASS_SYSFAIL =

System Failure

6
ERRCLASS_APPERR =

Application Error

7
ERRCLASS_NOTFND =

Not Found

8
ERRCLASS_BADFMT =

Bad Format

9
ERRCLASS_LOCKED =

Locked

10
ERRCLASS_MEDIA =

Media Failure

11
ERRCLASS_ALREADY =

Collision with Existing Item

12
ERRCLASS_UNK =

Unknown/other

13
ERRCLASS_CANT = 
14
ERRCLASS_TIME = 
15
ERRACT_RETRY =

Retry

1
ERRACT_DLYRET =

Delay Retry, retry after pause

2
ERRACT_USER =

Ask user to regive info

3
ERRACT_ABORT =

abort with clean up

4
ERRACT_PANIC =

abort immediately

5
ERRACT_IGNORE =

ignore

6
ERRACT_INTRET =

Retry after User Intervention

7
ERRLOC_UNK =

No appropriate value

1
ERRLOC_DISK =

Random Access Mass Storage

2
ERRLOC_NET =

Network

3
ERRLOC_SERDEV =

Serial Device

4
ERRLOC_MEM =

Memory

5
TC_NORMAL = 
0
TC_HARDERR = 
1
TC_GP_TRAP = 
2
TC_SIGNAL = 
3
ERROR_INVALID_FLAGS =

From WinError.h

4100
ERROR_NO_UNICODE_TRANSLATION =

1004L

4371
GetLastError = 
Win32API.new('kernel32', 'GetLastError', 'V', 'L')
SetLastError = 
Win32API.new('kernel32', 'SetLastError', 'L', 'V')
SetErrorMode = 
Win32API.new('kernel32', 'SetErrorMode', 'I', 'I')
FormatMessage = 
Win32API.new('kernel32', 'FormatMessage', 'LLLLPLP', 'L')
FormatMessageW = 
Win32API.new('kernel32', 'FormatMessageW', 'LLLLPLP', 'L')

Instance Method Summary collapse

Instance Method Details

#FormatMessage(flags, src, msg_id, lang_id, buf, size, args) ⇒ Object 



295
296
297
 
# File 'lib/windows/error.rb', line 295

def FormatMessage(flags, src, msg_id, lang_id, buf, size, args)
   FormatMessage.call(flags, src, msg_id, lang_id, buf, size, args)
end

#FormatMessageW(flags, src, msg_id, lang_id, buf, size, args) ⇒ Object 



299
300
301
 
# File 'lib/windows/error.rb', line 299

def FormatMessageW(flags, src, msg_id, lang_id, buf, size, args)
   FormatMessageW.call(flags, src, msg_id, lang_id, buf, size, args)
end

#get_last_error(err_num = GetLastError.call) ⇒ Object

Convenience method that wraps FormatMessage with some sane defaults and returns a human readable string.



314
315
316
317
318
319
 
# File 'lib/windows/error.rb', line 314

def get_last_error(err_num = GetLastError.call)
   buf   = 0.chr * 260
   flags = FORMAT_MESSAGE_FROM_SYSTEM + FORMAT_MESSAGE_ARGUMENT_ARRAY        
   FormatMessage.call(flags, 0, err_num, 0, buf, buf.size, 0)
   buf.split(0.chr).first.chomp rescue 'Unknown error'       
end

#GetLastError ⇒ Object 



283
284
285
 
# File 'lib/windows/error.rb', line 283

def GetLastError
   GetLastError.call
end

#SetErrorMode(mode) ⇒ Object 



291
292
293
 
# File 'lib/windows/error.rb', line 291

def SetErrorMode(mode)
   SetErrorMode.call(mode)
end

#SetLastError(error) ⇒ Object 



287
288
289
 
# File 'lib/windows/error.rb', line 287

def SetLastError(error)
   SetLastError.call(error)
end