1
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
2
/* ***** BEGIN LICENSE BLOCK *****
3
* Version: NPL 1.1/GPL 2.0/LGPL 2.1
5
* The contents of this file are subject to the Netscape Public License
6
* Version 1.1 (the "License"); you may not use this file except in
7
* compliance with the License. You may obtain a copy of the License at
8
* http://www.mozilla.org/NPL/
10
* Software distributed under the License is distributed on an "AS IS" basis,
11
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
12
* for the specific language governing rights and limitations under the
15
* The Original Code is mozilla.org code.
17
* The Initial Developer of the Original Code is
18
* Netscape Communications Corporation.
19
* Portions created by the Initial Developer are Copyright (C) 1998
20
* the Initial Developer. All Rights Reserved.
24
* Alternatively, the contents of this file may be used under the terms of
25
* either the GNU General Public License Version 2 or later (the "GPL"), or
26
* the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
27
* in which case the provisions of the GPL or the LGPL are applicable instead
28
* of those above. If you wish to allow use of your version of this file only
29
* under the terms of either the GPL or the LGPL, and not to allow others to
30
* use your version of this file under the terms of the NPL, indicate your
31
* decision by deleting the provisions above and replace them with the notice
32
* and other provisions required by the GPL or the LGPL. If you do not delete
33
* the provisions above, a recipient may use your version of this file under
34
* the terms of any one of the NPL, the GPL or the LGPL.
36
* ***** END LICENSE BLOCK ***** */
42
#include "nscore.h" /* needed for nsresult */
46
* To add error code to your module, you need to do the following:
48
* 1) Add a module offset code. Add yours to the bottom of the list
49
* right below this comment, adding 1.
51
* 2) In your module, define a header file which uses one of the
52
* NE_ERROR_GENERATExxxxxx macros. Some examples below:
54
* #define NS_ERROR_MYMODULE_MYERROR1 NS_ERROR_GENERATE(NS_ERROR_SEVERITY_ERROR,NS_ERROR_MODULE_MYMODULE,1)
55
* #define NS_ERROR_MYMODULE_MYERROR2 NS_ERROR_GENERATE_SUCCESS(NS_ERROR_MODULE_MYMODULE,2)
56
* #define NS_ERROR_MYMODULE_MYERROR3 NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_MYMODULE,3)
62
* @name Standard Module Offset Code. Each Module should identify a unique number
63
* and then all errors associated with that module become offsets from the
64
* base associated with that module id. There are 16 bits of code bits for
68
#define NS_ERROR_MODULE_XPCOM 1
69
#define NS_ERROR_MODULE_BASE 2
70
#define NS_ERROR_MODULE_GFX 3
71
#define NS_ERROR_MODULE_WIDGET 4
72
#define NS_ERROR_MODULE_CALENDAR 5
73
#define NS_ERROR_MODULE_NETWORK 6
74
#define NS_ERROR_MODULE_PLUGINS 7
75
#define NS_ERROR_MODULE_LAYOUT 8
76
#define NS_ERROR_MODULE_HTMLPARSER 9
77
#define NS_ERROR_MODULE_RDF 10
78
#define NS_ERROR_MODULE_UCONV 11
79
#define NS_ERROR_MODULE_REG 12
80
#define NS_ERROR_MODULE_FILES 13
81
#define NS_ERROR_MODULE_DOM 14
82
#define NS_ERROR_MODULE_IMGLIB 15
83
#define NS_ERROR_MODULE_MAILNEWS 16
84
#define NS_ERROR_MODULE_EDITOR 17
85
#define NS_ERROR_MODULE_XPCONNECT 18
86
#define NS_ERROR_MODULE_PROFILE 19
87
#define NS_ERROR_MODULE_LDAP 20
88
#define NS_ERROR_MODULE_SECURITY 21
89
#define NS_ERROR_MODULE_DOM_XPATH 22
90
#define NS_ERROR_MODULE_DOM_RANGE 23
91
#define NS_ERROR_MODULE_URILOADER 24
92
#define NS_ERROR_MODULE_CONTENT 25
93
#define NS_ERROR_MODULE_PYXPCOM 26
94
#define NS_ERROR_MODULE_XSLT 27
96
/* NS_ERROR_MODULE_GENERAL should be used by modules that do not
97
* care if return code values overlap. Callers of methods that
98
* return such codes should be aware that they are not
99
* globally unique. Implementors should be careful about blindly
100
* returning codes from other modules that might also use
103
#define NS_ERROR_MODULE_GENERAL 51
106
* @name Standard Error Handling Macros
109
#define NS_FAILED(_nsresult) (NS_UNLIKELY((_nsresult) & 0x80000000))
110
#define NS_SUCCEEDED(_nsresult) (NS_LIKELY(!((_nsresult) & 0x80000000)))
113
* @name Severity Code. This flag identifies the level of warning
116
#define NS_ERROR_SEVERITY_SUCCESS 0
117
#define NS_ERROR_SEVERITY_ERROR 1
120
* @name Mozilla Code. This flag separates consumers of mozilla code
121
* from the native platform
124
#define NS_ERROR_MODULE_BASE_OFFSET 0x45
127
* @name Standard Error Generating Macros
130
#define NS_ERROR_GENERATE(sev,module,code) \
131
((nsresult) (((PRUint32)(sev)<<31) | ((PRUint32)(module+NS_ERROR_MODULE_BASE_OFFSET)<<16) | ((PRUint32)(code))) )
133
#define NS_ERROR_GENERATE_SUCCESS(module,code) \
134
((nsresult) (((PRUint32)(NS_ERROR_SEVERITY_SUCCESS)<<31) | ((PRUint32)(module+NS_ERROR_MODULE_BASE_OFFSET)<<16) | ((PRUint32)(code))) )
136
#define NS_ERROR_GENERATE_FAILURE(module,code) \
137
((nsresult) (((PRUint32)(NS_ERROR_SEVERITY_ERROR)<<31) | ((PRUint32)(module+NS_ERROR_MODULE_BASE_OFFSET)<<16) | ((PRUint32)(code))) )
140
* @name Standard Macros for retrieving error bits
143
#define NS_ERROR_GET_CODE(err) ((err) & 0xffff)
144
#define NS_ERROR_GET_MODULE(err) (((((err) >> 16) - NS_ERROR_MODULE_BASE_OFFSET) & 0x1fff))
145
#define NS_ERROR_GET_SEVERITY(err) (((err) >> 31) & 0x1)
148
* @name Standard return values
153
/* Standard "it worked" return value */
156
#define NS_ERROR_BASE ((nsresult) 0xC1F30000)
158
/* Returned when an instance is not initialized */
159
#define NS_ERROR_NOT_INITIALIZED (NS_ERROR_BASE + 1)
161
/* Returned when an instance is already initialized */
162
#define NS_ERROR_ALREADY_INITIALIZED (NS_ERROR_BASE + 2)
164
/* Returned by a not implemented function */
165
#define NS_ERROR_NOT_IMPLEMENTED ((nsresult) 0x80004001L)
167
/* Returned when a given interface is not supported. */
168
#define NS_NOINTERFACE ((nsresult) 0x80004002L)
169
#define NS_ERROR_NO_INTERFACE NS_NOINTERFACE
171
#define NS_ERROR_INVALID_POINTER ((nsresult) 0x80004003L)
172
#define NS_ERROR_NULL_POINTER NS_ERROR_INVALID_POINTER
174
/* Returned when a function aborts */
175
#define NS_ERROR_ABORT ((nsresult) 0x80004004L)
177
/* Returned when a function fails */
178
#define NS_ERROR_FAILURE ((nsresult) 0x80004005L)
180
/* Returned when an unexpected error occurs */
181
#define NS_ERROR_UNEXPECTED ((nsresult) 0x8000ffffL)
183
/* Returned when a memory allocation fails */
184
#define NS_ERROR_OUT_OF_MEMORY ((nsresult) 0x8007000eL)
186
/* Returned when an illegal value is passed */
187
#define NS_ERROR_ILLEGAL_VALUE ((nsresult) 0x80070057L)
188
#define NS_ERROR_INVALID_ARG NS_ERROR_ILLEGAL_VALUE
190
/* Returned when a class doesn't allow aggregation */
191
#define NS_ERROR_NO_AGGREGATION ((nsresult) 0x80040110L)
193
/* Returned when an operation can't complete due to an unavailable resource */
194
#define NS_ERROR_NOT_AVAILABLE ((nsresult) 0x80040111L)
196
/* Returned when a class is not registered */
197
#define NS_ERROR_FACTORY_NOT_REGISTERED ((nsresult) 0x80040154L)
199
/* Returned when a class cannot be registered, but may be tried again later */
200
#define NS_ERROR_FACTORY_REGISTER_AGAIN ((nsresult) 0x80040155L)
202
/* Returned when a dynamically loaded factory couldn't be found */
203
#define NS_ERROR_FACTORY_NOT_LOADED ((nsresult) 0x800401f8L)
205
/* Returned when a factory doesn't support signatures */
206
#define NS_ERROR_FACTORY_NO_SIGNATURE_SUPPORT \
207
(NS_ERROR_BASE + 0x101)
209
/* Returned when a factory already is registered */
210
#define NS_ERROR_FACTORY_EXISTS (NS_ERROR_BASE + 0x100)
213
/* For COM compatibility reasons, we want to use exact error code numbers
214
for NS_ERROR_PROXY_INVALID_IN_PARAMETER and NS_ERROR_PROXY_INVALID_OUT_PARAMETER.
217
#define RPC_E_INVALID_PARAMETER _HRESULT_TYPEDEF_(0x80010010L)
219
Errors returning this mean that the xpcom proxy code could not create a proxy for
220
one of the in paramaters.
222
Because of this, we are ignoring the convention if using a base and offset for
227
/* Returned when a proxy could not be create a proxy for one of the IN parameters
228
This is returned only when the "real" meathod has NOT been invoked.
231
#define NS_ERROR_PROXY_INVALID_IN_PARAMETER ((nsresult) 0x80010010L)
233
/* Returned when a proxy could not be create a proxy for one of the OUT parameters
234
This is returned only when the "real" meathod has ALREADY been invoked.
237
#define NS_ERROR_PROXY_INVALID_OUT_PARAMETER ((nsresult) 0x80010011L)
245
#define NS_BASE_STREAM_CLOSED NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_BASE, 2)
246
/* Error from the operating system */
247
#define NS_BASE_STREAM_OSERROR NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_BASE, 3)
248
/* Illegal arguments */
249
#define NS_BASE_STREAM_ILLEGAL_ARGS NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_BASE, 4)
250
/* For unichar streams */
251
#define NS_BASE_STREAM_NO_CONVERTER NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_BASE, 5)
252
/* For unichar streams */
253
#define NS_BASE_STREAM_BAD_CONVERSION NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_BASE, 6)
255
#define NS_BASE_STREAM_WOULD_BLOCK NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_BASE, 7)
258
#define NS_ERROR_FILE_UNRECOGNIZED_PATH NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 1)
259
#define NS_ERROR_FILE_UNRESOLVABLE_SYMLINK NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 2)
260
#define NS_ERROR_FILE_EXECUTION_FAILED NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 3)
261
#define NS_ERROR_FILE_UNKNOWN_TYPE NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 4)
262
#define NS_ERROR_FILE_DESTINATION_NOT_DIR NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 5)
263
#define NS_ERROR_FILE_TARGET_DOES_NOT_EXIST NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 6)
264
#define NS_ERROR_FILE_COPY_OR_MOVE_FAILED NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 7)
265
#define NS_ERROR_FILE_ALREADY_EXISTS NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 8)
266
#define NS_ERROR_FILE_INVALID_PATH NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 9)
267
#define NS_ERROR_FILE_DISK_FULL NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 10)
268
#define NS_ERROR_FILE_CORRUPTED NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 11)
269
#define NS_ERROR_FILE_NOT_DIRECTORY NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 12)
270
#define NS_ERROR_FILE_IS_DIRECTORY NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 13)
271
#define NS_ERROR_FILE_IS_LOCKED NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 14)
272
#define NS_ERROR_FILE_TOO_BIG NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 15)
273
#define NS_ERROR_FILE_NO_DEVICE_SPACE NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 16)
274
#define NS_ERROR_FILE_NAME_TOO_LONG NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 17)
275
#define NS_ERROR_FILE_NOT_FOUND NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 18)
276
#define NS_ERROR_FILE_READ_ONLY NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 19)
277
#define NS_ERROR_FILE_DIR_NOT_EMPTY NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 20)
278
#define NS_ERROR_FILE_ACCESS_DENIED NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_FILES, 21)
280
#define NS_SUCCESS_FILE_DIRECTORY_EMPTY NS_ERROR_GENERATE_SUCCESS(NS_ERROR_MODULE_FILES, 1)
282
/* Result codes used by nsIVariant */
284
#define NS_ERROR_CANNOT_CONVERT_DATA NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_XPCOM, 1)
285
#define NS_ERROR_OBJECT_IS_IMMUTABLE NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_XPCOM, 2)
286
#define NS_ERROR_LOSS_OF_SIGNIFICANT_DATA NS_ERROR_GENERATE_FAILURE(NS_ERROR_MODULE_XPCOM, 3)
288
#define NS_SUCCESS_LOSS_OF_INSIGNIFICANT_DATA NS_ERROR_GENERATE_SUCCESS(NS_ERROR_MODULE_XPCOM, 1)
292
* This will return the nsresult corresponding to the most recent NSPR failure
293
* returned by PR_GetError.
295
***********************************************************************
296
* Do not depend on this function. It will be going away!
297
***********************************************************************
299
extern NS_COM nsresult
300
NS_ErrorAccordingToNSPR();
304
#pragma warning(disable: 4251) /* 'nsCOMPtr<class nsIInputStream>' needs to have dll-interface to be used by clients of class 'nsInputStream' */
305
#pragma warning(disable: 4275) /* non dll-interface class 'nsISupports' used as base for dll-interface class 'nsIRDFNode' */