Skip to content

Latest commit

 

History

History
75 lines (64 loc) · 2.41 KB

win32json_notes.md

File metadata and controls

75 lines (64 loc) · 2.41 KB
Raw

These are notes I jot down when working with the win32json source.

Constants

jq has been very useful to find the shape and common data of all the constants. For example, in the command below, I iterate over all files in the WinMetadata/json directory, and select all constants with "Kind": "ApiRef" which are not "Name": "HRESULT". By running this, I can find constants with other data.

# Step 1: select all constants where its kind is ApiRef and type.name is not HRESULT
Get-ChildItem -Path .\WinMetadata\json -File | ForEach-Object {
    echo "Checking $($_.FullName)..."
    Get-Content $_.FullName | jq '.Constants[] | select(.Type.Kind == "ApiRef" and .Type.Name != "HRESULT")'
}

# Result: constants with a type.name other than "HRESULT" - for example "PROPERTYKEY".

# Step 2: select all constants where its type.name is not "HRESULT" nor "PROPERTYKEY"
Get-ChildItem -Path .\WinMetadata\json -File | ForEach-Object {
    echo "Checking $($_.FullName)..."
    Get-Content $_.FullName | jq '.Constants[] | select(.Type.Kind == "ApiRef" and .Type.Name != "HRESULT" and .Type.Name != "PROPERTYKEY")'
}

# Result: constants with a type.name other than "HRESULT" nor "PROPERTYKEY" - for example "NTSTATUS".

# Step 3: select all constants where its type.name is not "HRESULT" nor "PROPERTYKEY" nor "NTSTATUS"
Get-ChildItem -Path .\WinMetadata\json -File | ForEach-Object {
    echo "Checking $($_.FullName)..."
    Get-Content $_.FullName | jq '.Constants[] | select(.Type.Kind == "ApiRef" and .Type.Name != "HRESULT" and .Type.Name != "PROPERTYKEY" and .Type.Name != "NTSTATUS")'
}

This way, I was able to find that ApiRef may have a type.name of:

  • HRESULT
  • PROPERTYKEY
  • NTSTATUS
  • PWSTR
  • SOCKET
  • HANDLE
  • PSTR
  • BCRYPT_ALG_HANDLE
  • HKEY
  • HBITMAP
  • HTREEITEM
  • DPI_AWARENESS_CONTEXT
  • HWND

Types

Next up, the Types property. It contains these Kinds:

  • ComClassID
  • Com
  • Enum
  • FunctionPointer
  • NativeTypedef
  • Struct
  • Union

The Platform property says which version of windows it was introduced. It exists both in the top-level Types object, and for each method in a COM interface. Platform can be any of:

  • null
  • windows10.0.19041
  • windows10.0.18362
  • windows10.0.17763
  • windows10.0.17134
  • windows10.0.16299
  • windows10.0.15063
  • windows10.0.14393
  • windows10.0.10240
  • windows8.1
  • windows8.0
  • windows6.1
  • windows6.0.6000
  • windows5.1.2600
  • windows5.0
  • windowsServer2012
  • windowsServer2003
  • windowsServer2008