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

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

 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 Details

  • Last update date: Monday May 30, 2022
  • Items count: 368054
  • Parsed files count: 9521
  • Windows SDK version: 10.0.22621.0
  • NetFx SDK version: 4.8
  • MSVC Tools version: 14.32.31326
  • KMDF version: 1.33
  • UMDF version: 2.33

 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.

 

 Privacy & Terms

This privacy policy is for the www.magnumdb.com website and governs the privacy of online users who choose to use it. It sets out the different areas where user privacy is concerned and outlines the obligations and requirements of the users, the website and website owners.

 Cookies

www.magnumdb.com uses cookies for the sole reason of monitoring and improving our services, using Google Analytics. You can however decide to opt out of having your anonymized browsing activity within this site recorded by monitoring cookies, if you follow the instructions from Google here: Google Analytics Opt-out Browser Add-on

 User Information Storage

www.magnumdb.com stores no User Information nor Personal Data, at all.

 Data Security and Retention

This site application is hosted in Microsoft Azure in the "Central US" data center. See Microsoft’s Azure Trust Center for more information.

We make reasonable efforts to ensure a level of security appropriate to the risk associated with the processing of data.

Unfortunately, no data transmission or storage system can be guaranteed to be 100% secure. If you have reason to believe that your interaction with us is no longer secure, please contact us immediately.

We do not retain any Personal Data. Where we retain data, we do so in accordance with any limitation periods and records retention obligations that are imposed by applicable law.

   Disclaimer

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.

 

 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

MagNumDB © 2017-2022 Simon Mourier V1.5.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.

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.

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 5.589989 ColorSpectrumShape::Box Int32 0 0x00000000 0 System.Int32
Box  = 0,
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\winrt\windows.ui.xaml.controls.idl(3548,0)
2 4.658324 Box Int32 310 0x00000136 310 System.Int32
static const int Box = 310;
%ProgramFiles%\Microsoft Visual Studio\2022\Professional\VSSDK\VisualStudioIntegration\Common\Inc\KnownImageIds.h(395,0)
3 3.952719 __magnumdb__enum_msodm_h_3::msodmotpCheckbox Int32 4 0x00000004 4 System.Int32
msodmotpCheckbox,				// Check box.
%ProgramFiles%\Microsoft Visual Studio\2022\Professional\VSSDK\VisualStudioIntegration\Common\Inc\office10\msodm.h(167,0)
4 3.952719 __magnumdb__enum_msodm_h_3::msodmotpGroupBox Int32 6 0x00000006 6 System.Int32
msodmotpGroupBox,				// Group box.
%ProgramFiles%\Microsoft Visual Studio\2022\Professional\VSSDK\VisualStudioIntegration\Common\Inc\office10\msodm.h(169,0)
5 3.952719 __magnumdb__enum_msodm_h_3::msodmotpListBox Int32 14 0x0000000E 14 System.Int32
msodmotpListBox,				// List box.
%ProgramFiles%\Microsoft Visual Studio\2022\Professional\VSSDK\VisualStudioIntegration\Common\Inc\office10\msodm.h(177,0)
6 3.952719 __magnumdb__enum_msodm_h_3::msodmotpComboBox Int32 16 0x00000010 16 System.Int32
msodmotpComboBox,				// Combo box.
%ProgramFiles%\Microsoft Visual Studio\2022\Professional\VSSDK\VisualStudioIntegration\Common\Inc\office10\msodm.h(179,0)
7 3.726659 DIBUTTON_REMOTE_CABLE Int32 654334985 0x27005C09 654334985 System.Int32
#define DIBUTTON_REMOTE_CABLE                   0x27005C09 /* Select cable box */
#define DIBUTTON_REMOTE_CABLE                   0x27005C09 /* Select cable box */
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\dinput.h(4196,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
8 3.293933 ICMF_CHOOSE_DATARATE Int32 2 0x00000002 2 System.Int32
#define ICMF_CHOOSE_DATARATE	0x0002	// show DataRate box
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\Vfw.h(1254,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOCOMPMAN
9 3.293933 ColorSpectrumShape Enum
enum ColorSpectrumShape
                {
                    Box  = 0,
                    Ring = 1
                };
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\winrt\windows.ui.xaml.controls.idl(3546,0)
10 3.260827 JET_ExceptionMsgBox Int32 1 0x00000001 1 System.Int32
#define JET_ExceptionMsgBox     0x0001      /* Display message box on exception */
#define JET_ExceptionMsgBox     0x0001      /* Display message box on exception */
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\esent.h(3022,0)
  • If !defined(_JET_INCLUDED)
11 3.260827 DIBUTTON_BASEBALLB_BOX Int32 251675658 0x0F00440A 251675658 System.Int32
#define DIBUTTON_BASEBALLB_BOX                  0x0F00440A /* Enter or exit batting box */
#define DIBUTTON_BASEBALLB_BOX                  0x0F00440A /* Enter or exit batting box */
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\dinput.h(3622,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
12 3.260827 DIBUTTON_SOCCERD_GOALIECHARGE Int32 520111115 0x1F00440B 520111115 System.Int32
#define DIBUTTON_SOCCERD_GOALIECHARGE           0x1F00440B /* Make the goalie charge out of the box */
#define DIBUTTON_SOCCERD_GOALIECHARGE           0x1F00440B /* Make the goalie charge out of the box */
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\dinput.h(4015,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
13 3.260827 __magnumdb__enum_msodebug_h_6::msoaoMsgBox Int32 4 0x00000004 4 System.Int32
msoaoMsgBox = 0x04,	/* output displayed in message box (no Traces) */
	msoaoMsgBox = 0x04,	/* output displayed in message box (no Traces) */
%ProgramFiles%\Microsoft Visual Studio\2022\Professional\VSSDK\VisualStudioIntegration\Common\Inc\office10\msodebug.h(237,0)
  • If !defined(MSODEBUG_H)
14 2.635146 CBEN_FIRST UInt64 18446744073709550816 0xFFFFFFFFFFFFFCE0 -800 System.UInt64
#define CBEN_FIRST              (0U-800U)       // combo box ex
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\commctrl.h(371,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
15 2.635146 DMSTATEFLAG_APPLYTOALL Int32 1 0x00000001 1 System.Int32
#define DMSTATEFLAG_APPLYTOALL      0x00000001  // Set if Apply To All check box is checked
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\RegStr.h(790,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
16 2.635146 ICMF_CHOOSE_KEYFRAME Int32 1 0x00000001 1 System.Int32
#define ICMF_CHOOSE_KEYFRAME	0x0001	// show KeyFrame Every box
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\Vfw.h(1253,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOCOMPMAN
17 2.635146 AM_ASPECT_RATIO_MODE::AM_ARMODE_LETTER_BOX Int32 1 0x00000001 1 System.Int32
AM_ARMODE_LETTER_BOX,	    // letter box the video, paint background color in the excess region
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\mpconfig.h(25,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
18 2.635146 CREDUI_FLAGS_REQUEST_ADMINISTRATOR Int32 4 0x00000004 4 System.Int32
#define CREDUI_FLAGS_REQUEST_ADMINISTRATOR  0x00004     // Populate list box with admin accounts
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\wincred.h(730,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)
19 2.635146 ICM_ABOUT Int32 20491 0x0000500B 20491 System.Int32
#define ICM_ABOUT                   (ICM_RESERVED+11)   // show the about box
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\Vfw.h(221,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOCOMPMAN
20 2.305753 BIF_UAHINT Int32 256 0x00000100 256 System.Int32
#define BIF_UAHINT              0x00000100   // Add a UA hint to the dialog, in place of the edit box. May not be combined with BIF_EDITBOX
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\shlobj_core.h(1183,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
21 2.305753 __magnumdb__enum_msodm_h_3 Enum
enum
	{
	msodmotpNil = 0,
	msodmotpEdit,					// Edit control.
	msodmotpCommand,				// Command (push) button.
	msodmotpDescrText,				// Descriptive text.
	msodmotpCheckbox,				// Check box.
	msodmotpRadioButton,			// Radio button in single radio group.
	msodmotpGroupBox,				// Group box.
	msodmotpToolsMenuItem,			// Tools menu item
	msodmotpToolsMenuDismissItem,	// Tools menu item that dismisses the dialog.
	msodmotpToolsMenuCheckbox, 		// Tools menu radio button
	msodmotpOpenBtnDropDnItem, 		// Open button dropdown Item:
	msodmotpOpenBtnDropDnCheckbox, 	// Open button dropdown radio button
	msodmotpStdButton,				// Standard push button.
	msodmotpPushButton,				// Normal push button.
	msodmotpListBox,				// List box.
	msodmotpDropList,				// Drop down.
	msodmotpComboBox,				// Combo box.
	msodmotpConvertButton,			// Convert button.
	msodmotpMax
	};
%ProgramFiles%\Microsoft Visual Studio\2022\Professional\VSSDK\VisualStudioIntegration\Common\Inc\office10\msodm.h(161,0)
22 1.630413 __magnumdb__enum_msodebug_h_6 Enum
enum
{
	msoaoDebugger = 0x01,	/* output to debugger */
	msoaoDebugger = 0x01,	/* output to debugger */
	msoaoFile = 0x02,	/* output goes to file */
	msoaoFile = 0x02,	/* output goes to file */
	msoaoMsgBox = 0x04,	/* output displayed in message box (no Traces) */
	msoaoMsgBox = 0x04,	/* output displayed in message box (no Traces) */
	msoaoPort = 0x08,	/* output sent to serial port */
	msoaoPort = 0x08,	/* output sent to serial port */
	msoaoMappedFile = 0x10,	/* output recorded in memory mapped file */
	msoaoMappedFile = 0x10,	/* output recorded in memory mapped file */
	msoaoDebugBreak = 0x20,	/* msoaoDebugger breaks into the debugger */
	msoaoDebugBreak = 0x20,	/* msoaoDebugger breaks into the debugger */

	msoaoAppend = 0x8000,	/* output appended to existing file */
	msoaoAppend = 0x8000,	/* output appended to existing file */
};
%ProgramFiles%\Microsoft Visual Studio\2022\Professional\VSSDK\VisualStudioIntegration\Common\Inc\office10\msodebug.h(233,0)
  • If !defined(MSODEBUG_H)
23 1.317573 AM_ASPECT_RATIO_MODE Enum
typedef enum _AM_ASPECT_RATIO_MODE
{
    AM_ARMODE_STRETCHED,	    // don't do any aspect ratio correction
    AM_ARMODE_LETTER_BOX,	    // letter box the video, paint background color in the excess region
    AM_ARMODE_CROP,		    // crop the video to the right aspect ratio
    AM_ARMODE_STRETCHED_AS_PRIMARY  // follow whatever the primary stream does (in terms of the mode as well as pict-aspect-ratio values)
} AM_ASPECT_RATIO_MODE;
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22621.0\um\mpconfig.h(22,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
24 1.317573 DriverUnifiedPosHealthCheckLevel Enum
typedef enum DriverUnifiedPosHealthCheckLevel
{
    UnknownHealthCheckLevel = 0, //
    POSInternal = 1, // performs a health check without altering the device. The device is tested by internal tests as far as possible.
    External = 2, // performs a more thorough test which may affect the device.  For example, a printer may produce some output.
    Interactive = 3 // may display a dialog box that displays test options and results so that you can test the device interactively. No APIs for testing interactively are currently supported.
} DriverUnifiedPosHealthCheckLevel;
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.22000.0\shared\pointofservicecommontypes.h(59,0)
  • If (NTDDI_VERSION >= NTDDI_WINTHRESHOLD)