The Magic Number Database

How does it work?

MagNumDB is a database that contains about 350,000 items. These items are constants, names, values all extracted from more than 6,000 header files (.h, .hxx, .hpp, .idl, etc.) provided by standard Windows and Visual Studio SDKs and WDKs.

Some values have been extracted from the very special uuid.lib file that contains the value of thousands of guids and property keys, not present anywhere else in header files. This can explain some duplicates (because names in uuid.lib are not always exactly the same as names in .h parsed files...).

It also contains around 36,0000 undocumented guids that we found ... meeeeep ...

"C2P5"

To build this database, we have tried many existing parsers, things like CLANG or other fine tools, but they just don't suit our needs. They can't handle thousands of files that don't compile together, they can't handle some specific (or just very old) Microsoft constructs or annotations, they don't remember the stack of #define directives that led to a definition, they only give you a final AST, not a partial one, etc.

So, in the end, we have written a C/C++ parser named C2P5 (for C/CPP/PreProcessor/Parser), tailored specifically for computing constants. C2P5 is capable of preprocessing, parsing and partially evaluating all header files as if they were included in a one big virtual project (that of course, does not compile) on a 32G RAM machine. It currently supports the following preprocessor and C/C++ constructs:

#define preprocessor that define constants
#define preprocessor that define expression to compute constants
C and C++ constants, strings and enum definitions, and some level of pointerness
Special GUID constructs like DECLSPEC_UUID, DEFINE_GUIDSTRUCT, MIDL_INTERFACE, you name it
PROPERTYKEY constructs
Some IDL constructs
Etc.

The parser remembers dynamic preprocessor definitions (#if, #ifdef, etc.) that are conditions for constants definitions and expression computation. All parsed items are saved in the database, as well as the associated conditions. There may be more than one item corresponding to a given name, if there are differences in their associated conditions stack.

C2P5 supports the following types of constants, regardless of the way they are defined in source files:

integer, signed or unsigned, from 8-bit to 128-bit
floating point number, single (32-bit) or double (64-bit)
globally unique identifier, or guid, uuid, CLSID, IID, etc.
string, in narrow, wide, or utf-8/16/32 formats
character, in narrow, wide, or utf-8/16/32 formats
pointer, a constant cast as a pointer
property key, or PROPERTYKEY, or PKEY, a combination of a guid (fmtid) and a 32-bit integer (id).

C2P5 and this MagNumDB web site are written in C# and use a Lucene database as a full-text search engine. C2P5 uses a custom ANTLR4cs C grammar for expression parsing, not for preprocessor parsing.

Frequently Asked Questions

Q: Can I run custom queries?
A: Yes. You can use Lucene's query syntax. Note the Database is case insensitive. Check out the list of columns with their corresponding database column names:
- Index: the item's index.
- Name: the item's name, or title. For enum values, it's prefixed with the enum's name.
  Corresponding database field: title.
- Type: the item's type, expressed in a specific, universal system.
  Corresponding database's field: valuetype, but use the value of the Storage type column for queries on items type.
- Value: the item's value. For string values, it's displayed as is w/o quotes nor escaping.
  Corresponding database field: value. There is also a typedvalue field that can contain database's Int32, Int64, Float, Double or String typed values.
- Hex Value: the item's hexadecimal value, only valid for integer types.
  There is no corresponding database field.
- Signed Value: the item's signed value, only valid for integer and double types. Useful when you found a unsigned number and want to get the corresponding signed value (uint -> int for example).
  There is no corresponding database field.
- Source lines(s): the source lines from which the item was extracted. Comments and characters such as TAB, CR are preserved.
  Corresponding database field: source.
- File path: the file path from which the item was extracted, terminated by the line index.
  Corresponding database field: filepath. There are also directory and filename fields. filename is useful to query for values in a given file.
- Score: Database's score value. Items are returned sorted by score.
- Guid formats: a utility columns that proposes all possible guid formats. Only valid for guid types.
  There is no corresponding database field
- Char type: the character encoding (narrow, wide, etc.). Only valid for char and string values.
  Corresponding database field: chartype.
- Storage type: the exact storage type in the database. Only used for specific queries.
  Corresponding database field: valuetype.
- Conditions: the list of preprocessor conditions for a given item. If a condition is surrounded with a REVERSE function, it means the reverse condition of what's surrounded was the condition.
  Corresponding database field: conditions. There may be multiple conditions fields for one item.
Some important points to note:
- If you search for a negative number (like error codes expressed using signed integers), you can surround the search with double quotes, for example searching for "-2147009290" is equivalent to searching for 0x80073CF6, 80073CF6 (or even 3CF6 in this specific case). If you don't surround negative numbers with double quotes, the system will search for signed and unsigned corresponding values.
- The full-text search uses items' name, value, hex value, guid formats, source lines, etc. so refine your search if you get back too many items.
- You can search for guid binary values using just a part of their full definition. For example, if you search for '79eac9c5', it will get you 3 guid entries
- Leading wild card search (*whatever) is allowed, but it may slow down the search significantly.
Here are some example or custom queries:

title:wm_user returns the WM_USER Windows message item, not all items that reference the WM_USER token.

title:wm_u* returns all items (Windows messages probably) whose name starts with WM_U*.

value:1024 AND title:wm_* returns all items (Windows messages probably) whose name starts with WM_U* and value is 1024. Note AND must be UPPERCASE for database to understand it as an AND operator.

value:"00000002-0000-0000-C000-000000000046" returns the IMalloc IID guid value.
Q: I always get back 400 items at most. Why?
A: The MagNumDb site currently limits the number of returned items to this value by design. This should be enough for most real search scenarios (like enums with a big list of values).
Q: Some values are empty. Why?
A: The expression evaluator cannot always compute the final value, because it sometimes require contextual information (custom defines, compiler architecture, etc.) that the parser doesn't have at parsing time. You can enable the Source line(s) column to check what's the corresponding source and try to work it out by yourself. The origin file path and line number is also included.
Q: Can I get all values for a given enum?
A: Sure. For example, __VSHPROPID is the name of an enum, and a query like this: parent:__VSHPROPID will get all the enum's values (66 entries).
Q: I sometimes get back items whose name starts with "__magnumdb__enum_". Why?
A: C allows unnamed enums. The MagNumDb parser just gives them a name, using the defining file name and a counter.
Q: I sometimes get back the same item/name twice or more with different values. For example: TARGET_IS_NT60_OR_LATER. Why?
A: This can be the case with defines. Their value may be different if they were surrounded by # directives (#if, #else, etc.) in the original source code. You can enable the Condition(s) column to check what are the corresponding conditions for a given item.
Note: if a condition is surrounded with a funny REVERSE function token, it means the reverse condition of what's surrounded.
Q: I can't connect from an IP address but from another one, it works. Why?
A: The server is constantly monitored for excessive usage. It's possible your IP address has been banned because massive sets of queries where observed. If you think this is an error, send us an email.

Database Metrics

Last update date: Thursday May 13, 2020
Items count: 340878
Parsed files count: 8447
Windows SDK version: 10.0.19041.0
NetFx SDK version: 4.8
MSVC Tools version: 14.25.28610

Rest API

There is a JSON version API (you will have to figure out the schema, it's pretty obvious) that you can call here (the search query is the 'q' parameter):

https://www.magnumdb.com/api.aspx?q=0xC000000D&key=you-api-key-goes-here

Note this API also has a 400 items maximum limit and the server is monitored for excessive usage (the key can be removed without notice). If you want to get a key, send us an email.

Contact

We welcome feedback.
Seen anything missing? A bug? A wrong value? Do you have any suggestion for improvements? Do you have an idea for a cool new feature?

Please contact us here

About MagNumDB

All product names, logos, and brands are property of their respective owners. All company, product and service names used in this website are for identification purposes only.

All values, names, source code fragments displayed here have been extracted from files that are property of their respective owners.

THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND OTHER THAN AS SPECIFICALLY SET FORTH IN THE LICENSE AGREEMENT, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.



enum SeekPosition { begin = 0x0, current = 0x1, end = 0x2 };
enum SeekPosition { begin = 0x0, current = 0x1, end = 0x2 };
msostcBeginTracking = 1,  // begin tracking normally
#define JET_errRollbackRequired             -1109 /* Must rollback current transaction -- cannot commit or begin a new one */
#define JET_errRollbackRequired             -1109 /* Must rollback current transaction -- cannot commit or begin a new one */
enum SeekPosition { begin = 0x0, current = 0x1, end = 0x2 };
enum SeekPosition { begin = 0x0, current = 0x1, end = 0x2 };
SCRIPT_JUSTIFY_ARABIC_NORMAL  = 7,   // Normal Middle-Of-Word glyph that connects to the right (begin)
#define ICM_COMPRESS_BEGIN          (ICM_USER+7)    // begin a series of compress calls.
#define ED_MODE_STOP_START             ED_BASE+1030L    // Indicate stopping at the begin of a tape
enum
	{
	msostcBeginTracking = 1,  // begin tracking normally
	msostcNonBlocking = 2,    // don't report to the app that the component is
	};
enum
{
	msodmWriteBe = 1, /* write out the BE record for this object */
	msodmWriteBe = 1, /* write out the BE record for this object */

	/* Here begin drawing only debug messages */
	/* Here begin drawing only debug messages */
	msodmDgvRcvOfHsp = 2001,
		/* Ask a DGV for the bounding rectangle (if any) of an HSP.
			hsp field thereof and fills out the rcv field. */
	msodmDgsWriteBePvAnchor,
		/* Write out the BE record for a host allocated pvAnchor. */
		/* Write out the BE record for a host allocated pvAnchor. */
	msodmDgsWriteBePvClient,
		/* Write out the BE record for any host allocated client data. */
		/* Write out the BE record for any host allocated client data. */
	msodmDgvsAfterMouseInsert,
		/* Passed to IMsoDrawingViewSite after a shape is interactively
			inserted with the mouse. lParam is really the inserted HSP. */
	msodmDgvsAfterMarquee,
		/* Passed to IMsoDrawingViewSite after one drags out a rectangle
			with the pointer tool selecting zero or more shapes. */
	msodmIsNotMso96,
		/* Returns FALSE if the specified object is implemented by MSO96.DLL.
			to DGV *. */
	msodmGetHdesShape,
		/* Ask a DGVs for its m_hdesShape (in *(MSOHDES *)lParam).  Returns
			FALSE if it filled out an HDES. */
	msodmGetHdesSelection,
		/* Ask a DGVs for its m_hdesSelection (in *(MSOHDES *)lParam).
			Returns FALSE if it filled out an HDES. */
	msodmDguiWriteBeForDgc,
		/* Ask a DGUI to write BEs for a DGC it allocated. */
		/* Ask a DGUI to write BEs for a DGC it allocated. */
	msodmDgsWriteBeTxid,
		/* Write out the BE record for the attached text of a shape. */
		/* Write out the BE record for the attached text of a shape. */
	msodmDgsWriteBePvAnchorUndo,
		/* Write out the BE record for a host anchor in the undo stack. */
		/* Write out the BE record for a host anchor in the undo stack. */
	msodmDgvsDragDrop,
		/* Let the host know that I just did a drag-drop from this window. */
		/* Let the host know that I just did a drag-drop from this window. */
};
typedef enum tag_SCRIPT_JUSTIFY {
    SCRIPT_JUSTIFY_NONE           = 0,   // Justification can't be applied at this glyph
    SCRIPT_JUSTIFY_ARABIC_BLANK   = 1,   // This glyph represents a blank in an Arabic run
    SCRIPT_JUSTIFY_CHARACTER      = 2,   // Inter-character justification point follows this glyph
    SCRIPT_JUSTIFY_RESERVED1      = 3,   // Reserved #1
    SCRIPT_JUSTIFY_BLANK          = 4,   // This glyph represents a blank outside an Arabic run
    SCRIPT_JUSTIFY_RESERVED2      = 5,   // Reserved #2
    SCRIPT_JUSTIFY_RESERVED3      = 6,   // Reserved #3
    SCRIPT_JUSTIFY_ARABIC_NORMAL  = 7,   // Normal Middle-Of-Word glyph that connects to the right (begin)
    SCRIPT_JUSTIFY_ARABIC_KASHIDA = 8,   // Kashida(U+640) in middle of word
    SCRIPT_JUSTIFY_ARABIC_ALEF    = 9,   // Final form of Alef-like (U+627, U+625, U+623, U+632)
    SCRIPT_JUSTIFY_ARABIC_HA      = 10,  // Final form of Ha (U+647)
    SCRIPT_JUSTIFY_ARABIC_RA      = 11,  // Final form of Ra (U+631)
    SCRIPT_JUSTIFY_ARABIC_BA      = 12,  // Middle-Of-Word form of Ba (U+628)
    SCRIPT_JUSTIFY_ARABIC_BARA    = 13,  // Ligature of alike (U+628,U+631)
    SCRIPT_JUSTIFY_ARABIC_SEEN    = 14,  // Highest priority: Initial shape of Seen(U+633) (end)
    SCRIPT_JUSTIFY_ARABIC_SEEN_M  = 15,  // Reserved #4
} SCRIPT_JUSTIFY;

Index	Score	Name	Type	Value	Hex value	Signed value	Guid formats	Char type	Storage type	Source line(s)	File path	Condition(s)
Index	Score	Name	Type	Value	Hex value	Signed value	Guid formats	Char type	Storage type	Source line(s)	File path	Condition(s)
1	3.950722	SeekPosition::begin	Int32	0	0x00000000	0			System.Int32	enum SeekPosition { begin = 0x0, current = 0x1, end = 0x2 };	%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VC\Tools\MSVC\14.25.28610\atlmfc\include\afx.h(1069,0)
2	3.491978	SeekPosition	Enum							enum SeekPosition { begin = 0x0, current = 0x1, end = 0x2 };	%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VC\Tools\MSVC\14.25.28610\atlmfc\include\afx.h(1069,0)
3	3.491978	__magnumdb__enum_msoci_h_9::msostcBeginTracking	Int32	1	0x00000001	1			System.Int32	msostcBeginTracking = 1, // begin tracking normally	%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\office10\msoci.h(239,0)
4	2.963042	JET_errRollbackRequired	Int32	-1109	0xFFFFFBAB	-1109			System.Int32	#define JET_errRollbackRequired -1109 /* Must rollback current transaction -- cannot commit or begin a new one / #define JET_errRollbackRequired -1109 / Must rollback current transaction -- cannot commit or begin a new one */	%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.19041.0\um\esent.h(3319,0)	If !defined(_JET_INCLUDED)
5	2.793583	SeekPosition::current	Int32	1	0x00000001	1			System.Int32	enum SeekPosition { begin = 0x0, current = 0x1, end = 0x2 };	%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VC\Tools\MSVC\14.25.28610\atlmfc\include\afx.h(1069,0)
6	2.793583	SeekPosition::end	Int32	2	0x00000002	2			System.Int32	enum SeekPosition { begin = 0x0, current = 0x1, end = 0x2 };	%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VC\Tools\MSVC\14.25.28610\atlmfc\include\afx.h(1069,0)
7	2.793583	SCRIPT_JUSTIFY::SCRIPT_JUSTIFY_ARABIC_NORMAL	Int32	7	0x00000007	7			System.Int32	SCRIPT_JUSTIFY_ARABIC_NORMAL = 7, // Normal Middle-Of-Word glyph that connects to the right (begin)	%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.19041.0\um\usp10.h(504,0)	If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
8	2.793583	ICM_COMPRESS_BEGIN	Int32	16391	0x00004007	16391			System.Int32	#define ICM_COMPRESS_BEGIN (ICM_USER+7) // begin a series of compress calls.	%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.19041.0\um\Vfw.h(247,0)	If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP) Ifndef NOCOMPMAN
9	2.793583	ED_MODE_STOP_START	Int32	5126	0x00001406	5126			System.Int32	#define ED_MODE_STOP_START ED_BASE+1030L // Indicate stopping at the begin of a tape	%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.19041.0\um\xprtdefs.h(672,0)	If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
10	2.793583	__magnumdb__enum_msoci_h_9	Enum							enum { msostcBeginTracking = 1, // begin tracking normally msostcNonBlocking = 2, // don't report to the app that the component is };	%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\office10\msoci.h(237,0)
11	0.9876806	__magnumdb__enum_msodebug_h_1	Enum							enum { msodmWriteBe = 1, /* write out the BE record for this object / msodmWriteBe = 1, / write out the BE record for this object / / Here begin drawing only debug messages / / Here begin drawing only debug messages / msodmDgvRcvOfHsp = 2001, / Ask a DGV for the bounding rectangle (if any) of an HSP. hsp field thereof and fills out the rcv field. / msodmDgsWriteBePvAnchor, / Write out the BE record for a host allocated pvAnchor. / / Write out the BE record for a host allocated pvAnchor. / msodmDgsWriteBePvClient, / Write out the BE record for any host allocated client data. / / Write out the BE record for any host allocated client data. / msodmDgvsAfterMouseInsert, / Passed to IMsoDrawingViewSite after a shape is interactively inserted with the mouse. lParam is really the inserted HSP. / msodmDgvsAfterMarquee, / Passed to IMsoDrawingViewSite after one drags out a rectangle with the pointer tool selecting zero or more shapes. / msodmIsNotMso96, / Returns FALSE if the specified object is implemented by MSO96.DLL. to DGV . / msodmGetHdesShape, /* Ask a DGVs for its m_hdesShape (in (MSOHDES )lParam). Returns FALSE if it filled out an HDES. / msodmGetHdesSelection, / Ask a DGVs for its m_hdesSelection (in (MSOHDES )lParam). Returns FALSE if it filled out an HDES. / msodmDguiWriteBeForDgc, / Ask a DGUI to write BEs for a DGC it allocated. / / Ask a DGUI to write BEs for a DGC it allocated. / msodmDgsWriteBeTxid, / Write out the BE record for the attached text of a shape. / / Write out the BE record for the attached text of a shape. / msodmDgsWriteBePvAnchorUndo, / Write out the BE record for a host anchor in the undo stack. / / Write out the BE record for a host anchor in the undo stack. / msodmDgvsDragDrop, / Let the host know that I just did a drag-drop from this window. / / Let the host know that I just did a drag-drop from this window. */ };	%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\office10\msodebug.h(45,0)	If !defined(MSODEBUG_H)
12	0.8729946	SCRIPT_JUSTIFY	Enum							typedef enum tag_SCRIPT_JUSTIFY { SCRIPT_JUSTIFY_NONE = 0, // Justification can't be applied at this glyph SCRIPT_JUSTIFY_ARABIC_BLANK = 1, // This glyph represents a blank in an Arabic run SCRIPT_JUSTIFY_CHARACTER = 2, // Inter-character justification point follows this glyph SCRIPT_JUSTIFY_RESERVED1 = 3, // Reserved #1 SCRIPT_JUSTIFY_BLANK = 4, // This glyph represents a blank outside an Arabic run SCRIPT_JUSTIFY_RESERVED2 = 5, // Reserved #2 SCRIPT_JUSTIFY_RESERVED3 = 6, // Reserved #3 SCRIPT_JUSTIFY_ARABIC_NORMAL = 7, // Normal Middle-Of-Word glyph that connects to the right (begin) SCRIPT_JUSTIFY_ARABIC_KASHIDA = 8, // Kashida(U+640) in middle of word SCRIPT_JUSTIFY_ARABIC_ALEF = 9, // Final form of Alef-like (U+627, U+625, U+623, U+632) SCRIPT_JUSTIFY_ARABIC_HA = 10, // Final form of Ha (U+647) SCRIPT_JUSTIFY_ARABIC_RA = 11, // Final form of Ra (U+631) SCRIPT_JUSTIFY_ARABIC_BA = 12, // Middle-Of-Word form of Ba (U+628) SCRIPT_JUSTIFY_ARABIC_BARA = 13, // Ligature of alike (U+628,U+631) SCRIPT_JUSTIFY_ARABIC_SEEN = 14, // Highest priority: Initial shape of Seen(U+633) (end) SCRIPT_JUSTIFY_ARABIC_SEEN_M = 15, // Reserved #4 } SCRIPT_JUSTIFY;	%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.19041.0\um\usp10.h(496,0)	If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)