How does it work?

MagNumDB is a database that contains about 300,000 items. These items are constants, names, values all extracted from more than 4,000 header files (.h, .hxx, .hpp, .idl, etc.) provided by standard Windows and Visual Studio SDKs.
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.

 "C2P5"

To build this database, we have written a powerful C/C++ parser named C2P5 (for C/CPP/PreProcessor/Parser), tailored specifically for this task. 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). 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++ enum definitions
  • Special GUID constructs like DECLSPEC_UUID, DEFINE_GUIDSTRUCT or MIDL_INTERFACE
  • 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.

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 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 Lucene'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 Lucene'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: Lucene'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 Lucene's 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 sometimes compute the final value, because it sometimes require contextual information (custom defines, compiler architecture, etc.) that the parser doesn't have. 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.

 Database Metrics

  • Last update date: Tuesday, 17 October 2017
  • Items count: 304412
  • Parsed files count: 4278
  • Windows SDK version: 10.0.16299.0

 

 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 Simon Mourier V1.0.3. 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 Conditions
Index Score Name Type Value Hex value Signed value Guid formats Char type Storage type Source line(s) File path Conditions
1 4.518828 HDN_FIRST UInt64 18446744073709551316 0xFFFFFFFFFFFFFED4 -300 System.UInt64
#define HDN_FIRST               (0U-300U)       // header
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(340,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
2 3.195294 HDN_ITEMCHANGINGA UInt64 18446744073709551316 0xFFFFFFFFFFFFFED4 -300 System.UInt64
#define HDN_ITEMCHANGINGA       (HDN_FIRST-0)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1053,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
3 3.195294 HDN_ITEMCHANGINGW UInt64 18446744073709551296 0xFFFFFFFFFFFFFEC0 -320 System.UInt64
#define HDN_ITEMCHANGINGW       (HDN_FIRST-20)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1054,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
4 3.195294 HDN_ITEMCHANGEDA UInt64 18446744073709551315 0xFFFFFFFFFFFFFED3 -301 System.UInt64
#define HDN_ITEMCHANGEDA        (HDN_FIRST-1)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1055,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
5 3.195294 HDN_ITEMCHANGEDW UInt64 18446744073709551295 0xFFFFFFFFFFFFFEBF -321 System.UInt64
#define HDN_ITEMCHANGEDW        (HDN_FIRST-21)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1056,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
6 3.195294 HDN_ITEMCLICKA UInt64 18446744073709551314 0xFFFFFFFFFFFFFED2 -302 System.UInt64
#define HDN_ITEMCLICKA          (HDN_FIRST-2)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1057,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
7 3.195294 HDN_ITEMCLICKW UInt64 18446744073709551294 0xFFFFFFFFFFFFFEBE -322 System.UInt64
#define HDN_ITEMCLICKW          (HDN_FIRST-22)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1058,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
8 3.195294 HDN_ITEMDBLCLICKA UInt64 18446744073709551313 0xFFFFFFFFFFFFFED1 -303 System.UInt64
#define HDN_ITEMDBLCLICKA       (HDN_FIRST-3)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1059,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
9 3.195294 HDN_ITEMDBLCLICKW UInt64 18446744073709551293 0xFFFFFFFFFFFFFEBD -323 System.UInt64
#define HDN_ITEMDBLCLICKW       (HDN_FIRST-23)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1060,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
10 3.195294 HDN_DIVIDERDBLCLICKA UInt64 18446744073709551311 0xFFFFFFFFFFFFFECF -305 System.UInt64
#define HDN_DIVIDERDBLCLICKA    (HDN_FIRST-5)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1061,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
11 3.195294 HDN_DIVIDERDBLCLICKW UInt64 18446744073709551291 0xFFFFFFFFFFFFFEBB -325 System.UInt64
#define HDN_DIVIDERDBLCLICKW    (HDN_FIRST-25)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1062,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
12 3.195294 HDN_BEGINTRACKA UInt64 18446744073709551310 0xFFFFFFFFFFFFFECE -306 System.UInt64
#define HDN_BEGINTRACKA         (HDN_FIRST-6)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1063,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
13 3.195294 HDN_BEGINTRACKW UInt64 18446744073709551290 0xFFFFFFFFFFFFFEBA -326 System.UInt64
#define HDN_BEGINTRACKW         (HDN_FIRST-26)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1064,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
14 3.195294 HDN_ENDTRACKA UInt64 18446744073709551309 0xFFFFFFFFFFFFFECD -307 System.UInt64
#define HDN_ENDTRACKA           (HDN_FIRST-7)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1065,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
15 3.195294 HDN_ENDTRACKW UInt64 18446744073709551289 0xFFFFFFFFFFFFFEB9 -327 System.UInt64
#define HDN_ENDTRACKW           (HDN_FIRST-27)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1066,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
16 3.195294 HDN_TRACKA UInt64 18446744073709551308 0xFFFFFFFFFFFFFECC -308 System.UInt64
#define HDN_TRACKA              (HDN_FIRST-8)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1067,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
17 3.195294 HDN_TRACKW UInt64 18446744073709551288 0xFFFFFFFFFFFFFEB8 -328 System.UInt64
#define HDN_TRACKW              (HDN_FIRST-28)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1068,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
18 3.195294 HDN_GETDISPINFOA UInt64 18446744073709551307 0xFFFFFFFFFFFFFECB -309 System.UInt64
#define HDN_GETDISPINFOA        (HDN_FIRST-9)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1069,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
19 3.195294 HDN_GETDISPINFOW UInt64 18446744073709551287 0xFFFFFFFFFFFFFEB7 -329 System.UInt64
#define HDN_GETDISPINFOW        (HDN_FIRST-29)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1070,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
20 3.195294 HDN_BEGINDRAG UInt64 18446744073709551306 0xFFFFFFFFFFFFFECA -310 System.UInt64
#define HDN_BEGINDRAG           (HDN_FIRST-10)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1071,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
21 3.195294 HDN_ENDDRAG UInt64 18446744073709551305 0xFFFFFFFFFFFFFEC9 -311 System.UInt64
#define HDN_ENDDRAG             (HDN_FIRST-11)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1072,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
22 3.195294 HDN_FILTERCHANGE UInt64 18446744073709551304 0xFFFFFFFFFFFFFEC8 -312 System.UInt64
#define HDN_FILTERCHANGE        (HDN_FIRST-12)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1073,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
23 3.195294 HDN_FILTERBTNCLICK UInt64 18446744073709551303 0xFFFFFFFFFFFFFEC7 -313 System.UInt64
#define HDN_FILTERBTNCLICK      (HDN_FIRST-13)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1074,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
24 3.195294 HDN_BEGINFILTEREDIT UInt64 18446744073709551302 0xFFFFFFFFFFFFFEC6 -314 System.UInt64
#define HDN_BEGINFILTEREDIT     (HDN_FIRST-14)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1077,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
  • If (_WIN32_IE >= 0x0600)
25 3.195294 HDN_ENDFILTEREDIT UInt64 18446744073709551301 0xFFFFFFFFFFFFFEC5 -315 System.UInt64
#define HDN_ENDFILTEREDIT       (HDN_FIRST-15)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1078,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
  • If (_WIN32_IE >= 0x0600)
26 3.195294 HDN_ITEMSTATEICONCLICK UInt64 18446744073709551300 0xFFFFFFFFFFFFFEC4 -316 System.UInt64
#define HDN_ITEMSTATEICONCLICK  (HDN_FIRST-16)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1082,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
  • If (NTDDI_VERSION >= NTDDI_VISTA)
27 3.195294 HDN_ITEMKEYDOWN UInt64 18446744073709551299 0xFFFFFFFFFFFFFEC3 -317 System.UInt64
#define HDN_ITEMKEYDOWN         (HDN_FIRST-17)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1083,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
  • If (NTDDI_VERSION >= NTDDI_VISTA)
28 3.195294 HDN_DROPDOWN UInt64 18446744073709551298 0xFFFFFFFFFFFFFEC2 -318 System.UInt64
#define HDN_DROPDOWN            (HDN_FIRST-18)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1084,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
  • If (NTDDI_VERSION >= NTDDI_VISTA)
29 3.195294 HDN_OVERFLOWCLICK UInt64 18446744073709551297 0xFFFFFFFFFFFFFEC1 -319 System.UInt64
#define HDN_OVERFLOWCLICK       (HDN_FIRST-19)
%ProgramFiles(x86)%\Windows Kits\10\Include\10.0.16299.0\um\commctrl.h(1085,0)
  • If WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP)
  • Ifndef NOUSER
  • Ifndef NOHEADER
  • If (NTDDI_VERSION >= NTDDI_VISTA)