How does it work?

MagNumDB is a database that contains about 360,000 items. These items are constants, names, values all extracted from more than 9,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 ...


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).

 Powered by

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 October 7, 2021
  • Items count: 362743
  • Parsed files count: 9541
  • Windows SDK version: 10.0.22000.0
  • NetFx SDK version: 4.8
  • MSVC Tools version: 14.29.30133

 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):

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.



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

MagNumDB  2017-2021 Simon Mourier V1.4.0. All rights reserved.

Profile for Simon Mourier at Stack Overflow, Q&A for professional and enthusiast programmers

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.


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 9.972809 __VSFINDOPTIONS::FR_OptionMask Int32 4095 0x00000FFF 4095 System.Int32
FR_OptionMask	= 0xfff,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(157,0)
2 9.972809 __VSFINDOPTIONS::FR_MatchCase Int32 1 0x00000001 1 System.Int32
FR_MatchCase	= 0x1,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(158,0)
3 9.972809 __VSFINDOPTIONS::FR_WholeWord Int32 2 0x00000002 2 System.Int32
FR_WholeWord	= 0x2,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(159,0)
4 9.972809 __VSFINDOPTIONS::FR_Hidden Int32 4 0x00000004 4 System.Int32
FR_Hidden	= 0x4,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(160,0)
5 9.972809 __VSFINDOPTIONS::FR_Backwards Int32 8 0x00000008 8 System.Int32
FR_Backwards	= 0x8,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(161,0)
6 9.972809 __VSFINDOPTIONS::FR_Selection Int32 16 0x00000010 16 System.Int32
FR_Selection	= 0x10,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(162,0)
7 9.972809 __VSFINDOPTIONS::FR_Block Int32 32 0x00000020 32 System.Int32
FR_Block	= 0x20,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(163,0)
8 9.972809 __VSFINDOPTIONS::FR_KeepCase Int32 64 0x00000040 64 System.Int32
FR_KeepCase	= 0x40,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(164,0)
9 9.972809 __VSFINDOPTIONS::FR_SubFolders Int32 256 0x00000100 256 System.Int32
FR_SubFolders	= 0x100,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(165,0)
10 9.972809 __VSFINDOPTIONS::FR_KeepOpen Int32 512 0x00000200 512 System.Int32
FR_KeepOpen	= 0x200,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(166,0)
11 9.972809 __VSFINDOPTIONS::FR_NameOnly Int32 1024 0x00000400 1024 System.Int32
FR_NameOnly	= 0x400,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(167,0)
12 9.972809 __VSFINDOPTIONS::FR_SyntaxMask Int32 12288 0x00003000 12288 System.Int32
FR_SyntaxMask	= 0x3000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(168,0)
13 9.972809 __VSFINDOPTIONS::FR_Plain Int32 0 0x00000000 0 System.Int32
FR_Plain	= 0,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(169,0)
14 9.972809 __VSFINDOPTIONS::FR_Wildcard Int32 4096 0x00001000 4096 System.Int32
FR_Wildcard	= 0x1000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(170,0)
15 9.972809 __VSFINDOPTIONS::FR_RegExpr Int32 8192 0x00002000 8192 System.Int32
FR_RegExpr	= 0x2000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(171,0)
16 9.972809 __VSFINDOPTIONS::FR_TargetMask Int32 458752 0x00070000 458752 System.Int32
FR_TargetMask	= 0x70000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(172,0)
17 9.972809 __VSFINDOPTIONS::FR_Document Int32 65536 0x00010000 65536 System.Int32
FR_Document	= 0x10000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(173,0)
18 9.972809 __VSFINDOPTIONS::FR_OpenDocuments Int32 131072 0x00020000 131072 System.Int32
FR_OpenDocuments	= 0x20000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(174,0)
19 9.972809 __VSFINDOPTIONS::FR_Files Int32 196608 0x00030000 196608 System.Int32
FR_Files	= 0x30000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(175,0)
20 9.972809 __VSFINDOPTIONS::FR_Project Int32 262144 0x00040000 262144 System.Int32
FR_Project	= 0x40000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(176,0)
21 9.972809 __VSFINDOPTIONS::FR_Solution Int32 327680 0x00050000 327680 System.Int32
FR_Solution	= 0x50000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(177,0)
22 9.972809 __VSFINDOPTIONS::FR_ActionMask Int32 16252928 0x00F80000 16252928 System.Int32
FR_ActionMask	= 0xf80000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(178,0)
23 9.972809 __VSFINDOPTIONS::FR_MarkAll Int32 524288 0x00080000 524288 System.Int32
FR_MarkAll	= 0x80000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(179,0)
24 9.972809 __VSFINDOPTIONS::FR_Find Int32 1048576 0x00100000 1048576 System.Int32
FR_Find	= 0x100000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(180,0)
25 9.972809 __VSFINDOPTIONS::FR_FindAll Int32 2097152 0x00200000 2097152 System.Int32
FR_FindAll	= 0x200000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(181,0)
26 9.972809 __VSFINDOPTIONS::FR_Replace Int32 4194304 0x00400000 4194304 System.Int32
FR_Replace	= 0x400000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(182,0)
27 9.972809 __VSFINDOPTIONS::FR_ReplaceAll Int32 8388608 0x00800000 8388608 System.Int32
FR_ReplaceAll	= 0x800000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(183,0)
28 9.972809 __VSFINDOPTIONS::FR_InternalMask Int32 2130706432 0x7F000000 2130706432 System.Int32
FR_InternalMask	= 0x7f000000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(184,0)
29 9.972809 __VSFINDOPTIONS::FR_ResetPosition Int32 16777216 0x01000000 16777216 System.Int32
FR_ResetPosition	= 0x1000000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(185,0)
30 9.972809 __VSFINDOPTIONS::FR_FromStart Int32 33554432 0x02000000 33554432 System.Int32
FR_FromStart	= 0x2000000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(186,0)
31 9.972809 __VSFINDOPTIONS::FR_OneMatchPerLine Int32 67108864 0x04000000 67108864 System.Int32
FR_OneMatchPerLine	= 0x4000000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(187,0)
32 9.972809 __VSFINDOPTIONS::FR_Report Int32 134217728 0x08000000 134217728 System.Int32
FR_Report	= 0x8000000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(188,0)
33 9.972809 __VSFINDOPTIONS::FR_SelectionDefault Int32 268435456 0x10000000 268435456 System.Int32
FR_SelectionDefault	= 0x10000000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(189,0)
34 9.972809 __VSFINDOPTIONS::FR_NoFind UInt32 2147483648 0x80000000 -2147483648 System.UInt32
FR_NoFind	= 0x80000000,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(190,0)
35 9.972809 __VSFINDOPTIONS::FR_CommonOptions Int32 71 0x00000047 71 System.Int32
FR_CommonOptions	= ( ( ( FR_MatchCase | FR_WholeWord )  | FR_Hidden )  | FR_KeepCase ) ,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(191,0)
36 9.972809 __VSFINDOPTIONS::FR_DocOptionSet Int32 127 0x0000007F 127 System.Int32
FR_DocOptionSet	= ( ( ( FR_CommonOptions | FR_Backwards )  | FR_Selection )  | FR_Block ) ,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(192,0)
37 9.972809 __VSFINDOPTIONS::FR_FIFOptionSet Int32 1863 0x00000747 1863 System.Int32
FR_FIFOptionSet	= ( ( ( FR_CommonOptions | FR_SubFolders )  | FR_KeepOpen )  | FR_NameOnly ) ,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(193,0)
38 9.972809 __VSFINDOPTIONS::FR_OptionSet Int32 1919 0x0000077F 1919 System.Int32
FR_OptionSet	= ( FR_DocOptionSet | FR_FIFOptionSet ) ,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(194,0)
39 9.972809 __VSFINDOPTIONS::FR_SyntaxSet Int32 12288 0x00003000 12288 System.Int32
FR_SyntaxSet	= ( ( FR_Plain | FR_Wildcard )  | FR_RegExpr ) ,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(195,0)
40 9.972809 __VSFINDOPTIONS::FR_ScopeMask Int32 458800 0x00070030 458800 System.Int32
FR_ScopeMask	= ( ( FR_TargetMask | FR_Selection )  | FR_Block ) ,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(196,0)
41 9.972809 __VSFINDOPTIONS::FR_Capabilities Int32 284702591 0x10F8377F 284702591 System.Int32
FR_Capabilities	= ( ( ( FR_OptionSet | FR_SyntaxSet )  | FR_ActionMask )  | FR_SelectionDefault ) ,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(197,0)
42 9.972809 __VSFINDOPTIONS::FR_All Int32 2147483647 0x7FFFFFFF 2147483647 System.Int32
FR_All	= 0x7fffffff,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(198,0)
43 9.972809 __VSFINDOPTIONS::FR_None Int32 0 0x00000000 0 System.Int32
FR_None	= 0,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(199,0)
44 9.972809 __VSFINDOPTIONS::FR_Procedure Int32 32 0x00000020 32 System.Int32
FR_Procedure	= FR_Block,
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(200,0)
45 9.972809 __VSFINDOPTIONS::FR_Pattern Int32 4096 0x00001000 4096 System.Int32
FR_Pattern	= FR_Wildcard
%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Professional\VSSDK\VisualStudioIntegration\Common\Inc\textfind.h(201,0)