Files
histsdk/docs/reverse-engineering/dnlib-historianclient-getnextrow-target-latest.json
T
dohertj2 c95824a65d Initial commit: managed .NET 10 AVEVA Historian SDK + reverse-engineering toolkit
Full read-only SDK (src/AVEVA.Historian.Client) implementing the CLAUDE.md required
surface against AVEVA Historian's binary WCF protocol — no native AVEVA runtime
dependency. All operations live-verified against a local Historian:

- ProbeAsync, ReadRawAsync, ReadAggregateAsync, ReadAtTimeAsync, ReadEventsAsync
- BrowseTagNamesAsync, GetTagMetadataAsync (17 native data-type codes mapped)
- GetConnectionStatusAsync, GetStoreForwardStatusAsync, GetSystemParameterAsync
- 108/108 unit + integration tests pass

Includes the reverse-engineering toolkit (tools/AVEVA.Historian.ReverseEngineering)
used to decode the protocol: WCF probes, IL inspection via dnlib, and IL-rewrite
instrumentation (instrument-wcf-{write,read}message etc.) plus the .NET Framework
trace harness (tools/AVEVA.Historian.NativeTraceHarness) for parity testing.

Sanitized handoff evidence under docs/reverse-engineering/. Native AVEVA binaries
(current/, aveva-install-x64/, aveva-install-x86/) are gitignored — fetch separately
from the AVEVA installer.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-04 06:31:48 -04:00

562 lines
15 KiB
JSON

{
"Path": "C:\\Users\\dohertj2\\Desktop\\histsdk\\current\\aahClientManaged.dll",
"Filter": "0x0600588D",
"IsILOnly": false,
"IsMixedMode": true,
"Methods": [
{
"DeclaringType": "\u003CModule\u003E",
"Name": {
"String": "HistorianClient.GetNextRow\u003Cclass DataQueryResultRow\u003E",
"Data": "SGlzdG9yaWFuQ2xpZW50LkdldE5leHRSb3c8Y2xhc3MgRGF0YVF1ZXJ5UmVzdWx0Um93Pg==",
"Length": 52,
"DataLength": 52
},
"Token": "0x0600588D",
"Rva": "0x0042F818",
"IsStatic": true,
"IsPublic": false,
"HasBody": true,
"InstructionCount": 81,
"Locals": [
{
"Index": 0,
"Type": "System.Boolean"
},
{
"Index": 1,
"Type": "SError/value"
},
{
"Index": 2,
"Type": "std.shared_ptr\u003CQuery\u003E"
},
{
"Index": 3,
"Type": "System.UInt32"
}
],
"Calls": [
{
"Offset": "0x0006",
"OpCode": "call",
"Operand": "std.shared_ptr\u003CQuery\u003E* modreq(System.Runtime.CompilerServices.IsUdtReturn) modopt(System.Runtime.CompilerServices.CallConvCdecl) \u003CModule\u003E::HistorianClient.GetQuery(HistorianClient* modopt(System.Runtime.CompilerServices.IsConst) modopt(System.Runtime.CompilerServices.IsConst),std.shared_ptr\u003CQuery\u003E*,System.UInt32 modopt(System.Runtime.CompilerServices.IsLong))",
"Token": "0x060055C5"
},
{
"Offset": "0x0033",
"OpCode": "call",
"Operand": "System.Void modopt(System.Runtime.CompilerServices.CallConvCdecl) \u003CModule\u003E::SError.ClearErrorDetail(SError* modopt(System.Runtime.CompilerServices.IsConst) modopt(System.Runtime.CompilerServices.IsConst))",
"Token": "0x06000165"
},
{
"Offset": "0x0056",
"OpCode": "call",
"Operand": "System.Boolean modopt(System.Runtime.CompilerServices.CallConvCdecl) \u003CModule\u003E::Query.GetNextQueryResultRow\u003Cclass DataQueryResultRow\u003E(Query* modopt(System.Runtime.CompilerServices.IsConst) modopt(System.Runtime.CompilerServices.IsConst),DataQueryResultRow*,SError* modopt(System.Runtime.CompilerServices.IsImplicitlyDereferenced))",
"Token": "0x060058AF"
},
{
"Offset": "0x0066",
"OpCode": "call",
"Operand": "System.Void \u003CModule\u003E::___CxxCallUnwindDtor(System.Void (System.Void*),System.Void*)",
"Token": "0x06005C0F"
},
{
"Offset": "0x0078",
"OpCode": "call",
"Operand": "System.Void modopt(System.Runtime.CompilerServices.CallConvCdecl) \u003CModule\u003E::std._Ref_count_base._Decref(std._Ref_count_base* modopt(System.Runtime.CompilerServices.IsConst) modopt(System.Runtime.CompilerServices.IsConst))",
"Token": "0x06000137"
}
],
"Instructions": [
{
"Offset": "0x0000",
"OpCode": "ldc.i4.0",
"Operand": null,
"Token": null
},
{
"Offset": "0x0001",
"OpCode": "stloc.3",
"Operand": null,
"Token": null
},
{
"Offset": "0x0002",
"OpCode": "ldarg.0",
"Operand": null,
"Token": null
},
{
"Offset": "0x0003",
"OpCode": "ldloca.s",
"Operand": "V_2",
"Token": null
},
{
"Offset": "0x0005",
"OpCode": "ldarg.1",
"Operand": null,
"Token": null
},
{
"Offset": "0x0006",
"OpCode": "call",
"Operand": "std.shared_ptr\u003CQuery\u003E* modreq(System.Runtime.CompilerServices.IsUdtReturn) modopt(System.Runtime.CompilerServices.CallConvCdecl) \u003CModule\u003E::HistorianClient.GetQuery(HistorianClient* modopt(System.Runtime.CompilerServices.IsConst) modopt(System.Runtime.CompilerServices.IsConst),std.shared_ptr\u003CQuery\u003E*,System.UInt32 modopt(System.Runtime.CompilerServices.IsLong))",
"Token": "0x060055C5"
},
{
"Offset": "0x000B",
"OpCode": "pop",
"Operand": null,
"Token": null
},
{
"Offset": "0x000C",
"OpCode": "ldloca.s",
"Operand": "V_2",
"Token": null
},
{
"Offset": "0x000E",
"OpCode": "ldind.i8",
"Operand": null,
"Token": null
},
{
"Offset": "0x000F",
"OpCode": "ldc.i4.0",
"Operand": null,
"Token": null
},
{
"Offset": "0x0010",
"OpCode": "conv.i8",
"Operand": null,
"Token": null
},
{
"Offset": "0x0011",
"OpCode": "bne.un.s",
"Operand": "IL_0016: ldc.i4.1",
"Token": null
},
{
"Offset": "0x0013",
"OpCode": "ldc.i4.0",
"Operand": null,
"Token": null
},
{
"Offset": "0x0014",
"OpCode": "br.s",
"Operand": "IL_0017: conv.u1",
"Token": null
},
{
"Offset": "0x0016",
"OpCode": "ldc.i4.1",
"Operand": null,
"Token": null
},
{
"Offset": "0x0017",
"OpCode": "conv.u1",
"Operand": null,
"Token": null
},
{
"Offset": "0x0018",
"OpCode": "brtrue.s",
"Operand": "IL_0051: ldloca.s V_2",
"Token": null
},
{
"Offset": "0x001A",
"OpCode": "ldarg.1",
"Operand": null,
"Token": null
},
{
"Offset": "0x001B",
"OpCode": "ldc.i4.0",
"Operand": null,
"Token": null
},
{
"Offset": "0x001C",
"OpCode": "bne.un.s",
"Operand": "IL_0022: ldc.i4.s 51",
"Token": null
},
{
"Offset": "0x001E",
"OpCode": "ldc.i4.s",
"Operand": "30",
"Token": null
},
{
"Offset": "0x0020",
"OpCode": "br.s",
"Operand": "IL_0024: stloc.1",
"Token": null
},
{
"Offset": "0x0022",
"OpCode": "ldc.i4.s",
"Operand": "51",
"Token": null
},
{
"Offset": "0x0024",
"OpCode": "stloc.1",
"Operand": null,
"Token": null
},
{
"Offset": "0x0025",
"OpCode": "ldarg.3",
"Operand": null,
"Token": null
},
{
"Offset": "0x0026",
"OpCode": "ldc.i4.s",
"Operand": "12",
"Token": null
},
{
"Offset": "0x0028",
"OpCode": "conv.i8",
"Operand": null,
"Token": null
},
{
"Offset": "0x0029",
"OpCode": "add",
"Operand": null,
"Token": null
},
{
"Offset": "0x002A",
"OpCode": "ldc.i4.0",
"Operand": null,
"Token": null
},
{
"Offset": "0x002B",
"OpCode": "stind.i4",
"Operand": null,
"Token": null
},
{
"Offset": "0x002C",
"OpCode": "ldarg.3",
"Operand": null,
"Token": null
},
{
"Offset": "0x002D",
"OpCode": "ldc.i4.8",
"Operand": null,
"Token": null
},
{
"Offset": "0x002E",
"OpCode": "conv.i8",
"Operand": null,
"Token": null
},
{
"Offset": "0x002F",
"OpCode": "add",
"Operand": null,
"Token": null
},
{
"Offset": "0x0030",
"OpCode": "ldc.i4.0",
"Operand": null,
"Token": null
},
{
"Offset": "0x0031",
"OpCode": "stind.i4",
"Operand": null,
"Token": null
},
{
"Offset": "0x0032",
"OpCode": "ldarg.3",
"Operand": null,
"Token": null
},
{
"Offset": "0x0033",
"OpCode": "call",
"Operand": "System.Void modopt(System.Runtime.CompilerServices.CallConvCdecl) \u003CModule\u003E::SError.ClearErrorDetail(SError* modopt(System.Runtime.CompilerServices.IsConst) modopt(System.Runtime.CompilerServices.IsConst))",
"Token": "0x06000165"
},
{
"Offset": "0x0038",
"OpCode": "ldarg.3",
"Operand": null,
"Token": null
},
{
"Offset": "0x0039",
"OpCode": "ldc.i4.s",
"Operand": "12",
"Token": null
},
{
"Offset": "0x003B",
"OpCode": "conv.i8",
"Operand": null,
"Token": null
},
{
"Offset": "0x003C",
"OpCode": "add",
"Operand": null,
"Token": null
},
{
"Offset": "0x003D",
"OpCode": "ldc.i4.4",
"Operand": null,
"Token": null
},
{
"Offset": "0x003E",
"OpCode": "stind.i4",
"Operand": null,
"Token": null
},
{
"Offset": "0x003F",
"OpCode": "ldarg.3",
"Operand": null,
"Token": null
},
{
"Offset": "0x0040",
"OpCode": "ldc.i4.8",
"Operand": null,
"Token": null
},
{
"Offset": "0x0041",
"OpCode": "conv.i8",
"Operand": null,
"Token": null
},
{
"Offset": "0x0042",
"OpCode": "add",
"Operand": null,
"Token": null
},
{
"Offset": "0x0043",
"OpCode": "ldloca.s",
"Operand": "V_1",
"Token": null
},
{
"Offset": "0x0045",
"OpCode": "ldind.i4",
"Operand": null,
"Token": null
},
{
"Offset": "0x0046",
"OpCode": "stind.i4",
"Operand": null,
"Token": null
},
{
"Offset": "0x0047",
"OpCode": "ldloca.s",
"Operand": "V_1",
"Token": null
},
{
"Offset": "0x0049",
"OpCode": "ldind.i4",
"Operand": null,
"Token": null
},
{
"Offset": "0x004A",
"OpCode": "ldc.i4.0",
"Operand": null,
"Token": null
},
{
"Offset": "0x004B",
"OpCode": "ceq",
"Operand": null,
"Token": null
},
{
"Offset": "0x004D",
"OpCode": "conv.u1",
"Operand": null,
"Token": null
},
{
"Offset": "0x004E",
"OpCode": "stloc.0",
"Operand": null,
"Token": null
},
{
"Offset": "0x004F",
"OpCode": "leave.s",
"Operand": "IL_006C: ldloca.s V_2",
"Token": null
},
{
"Offset": "0x0051",
"OpCode": "ldloca.s",
"Operand": "V_2",
"Token": null
},
{
"Offset": "0x0053",
"OpCode": "ldind.i8",
"Operand": null,
"Token": null
},
{
"Offset": "0x0054",
"OpCode": "ldarg.2",
"Operand": null,
"Token": null
},
{
"Offset": "0x0055",
"OpCode": "ldarg.3",
"Operand": null,
"Token": null
},
{
"Offset": "0x0056",
"OpCode": "call",
"Operand": "System.Boolean modopt(System.Runtime.CompilerServices.CallConvCdecl) \u003CModule\u003E::Query.GetNextQueryResultRow\u003Cclass DataQueryResultRow\u003E(Query* modopt(System.Runtime.CompilerServices.IsConst) modopt(System.Runtime.CompilerServices.IsConst),DataQueryResultRow*,SError* modopt(System.Runtime.CompilerServices.IsImplicitlyDereferenced))",
"Token": "0x060058AF"
},
{
"Offset": "0x005B",
"OpCode": "stloc.0",
"Operand": null,
"Token": null
},
{
"Offset": "0x005C",
"OpCode": "leave.s",
"Operand": "IL_006C: ldloca.s V_2",
"Token": null
},
{
"Offset": "0x005E",
"OpCode": "ldftn",
"Operand": "System.Void modopt(System.Runtime.CompilerServices.CallConvCdecl) \u003CModule\u003E::std.shared_ptr\u003CQuery\u003E.{dtor}(std.shared_ptr\u003CQuery\u003E* modopt(System.Runtime.CompilerServices.IsConst) modopt(System.Runtime.CompilerServices.IsConst))",
"Token": "0x0600562A"
},
{
"Offset": "0x0064",
"OpCode": "ldloca.s",
"Operand": "V_2",
"Token": null
},
{
"Offset": "0x0066",
"OpCode": "call",
"Operand": "System.Void \u003CModule\u003E::___CxxCallUnwindDtor(System.Void (System.Void*),System.Void*)",
"Token": "0x06005C0F"
},
{
"Offset": "0x006B",
"OpCode": "endfinally",
"Operand": null,
"Token": null
},
{
"Offset": "0x006C",
"OpCode": "ldloca.s",
"Operand": "V_2",
"Token": null
},
{
"Offset": "0x006E",
"OpCode": "ldc.i4.8",
"Operand": null,
"Token": null
},
{
"Offset": "0x006F",
"OpCode": "add",
"Operand": null,
"Token": null
},
{
"Offset": "0x0070",
"OpCode": "ldind.i8",
"Operand": null,
"Token": null
},
{
"Offset": "0x0071",
"OpCode": "brfalse.s",
"Operand": "IL_007D: ldloc.0",
"Token": null
},
{
"Offset": "0x0073",
"OpCode": "ldloca.s",
"Operand": "V_2",
"Token": null
},
{
"Offset": "0x0075",
"OpCode": "ldc.i4.8",
"Operand": null,
"Token": null
},
{
"Offset": "0x0076",
"OpCode": "add",
"Operand": null,
"Token": null
},
{
"Offset": "0x0077",
"OpCode": "ldind.i8",
"Operand": null,
"Token": null
},
{
"Offset": "0x0078",
"OpCode": "call",
"Operand": "System.Void modopt(System.Runtime.CompilerServices.CallConvCdecl) \u003CModule\u003E::std._Ref_count_base._Decref(std._Ref_count_base* modopt(System.Runtime.CompilerServices.IsConst) modopt(System.Runtime.CompilerServices.IsConst))",
"Token": "0x06000137"
},
{
"Offset": "0x007D",
"OpCode": "ldloc.0",
"Operand": null,
"Token": null
},
{
"Offset": "0x007E",
"OpCode": "ret",
"Operand": null,
"Token": null
}
]
}
]
}