common

Common scripts

dotnet.js

Calls the DotNetBridge.dll COM component registered on the machine and exposes namespaces and types.

Example

const CLR = require("../common/dotnet");
const System = new CLR.Namespace("System");

// and then call any API like so:
System.Threading.Thread.Sleep(1000);
System.Diagnostics.Trace.WriteLine("hello");

Event handlers:

var eventToken = System.AppDomain.CurrentDomain.AssemblyLoad += new System.AssemblyLoadEventHandler(function (s, e) { asmLoaded = true;});

More examples: Test-DotNetBridge.js

dotnet-debug.js

Connect Trace.WriteLine() to write to console.log() for debugging purposes:

const CLRDebug = require('../common/DotNet-debug');
CLRDebug.EnableTraceListener();

Win32.js

Win32.Abi

Returns win64 or stdcall.

guid.js

Read and write GUID data:

var guidPtr = GUID.alloc("{6fdf6ffc-ed77-94fa-407e-a7b86ed9e59d}");
var guidStr = GUID.read(guidPtr);

struct.js

Create a BROWSEINFOW struct at browseinfoPtr:

var browseinfo = new Struct({
    'hwndOwner':'int',
    'pidlRoot':'pointer',
    'pszDisplayName':'pointer',
    'lpszTitle':'pointer',
    'ulFlags':'uint',
    'lpfn':'pointer',
    'lParam':'long',
    'iImage':'int',
}, browseinfoPtr);

Then read or write as javascript object properties:

console.log("Flags: 0x" + browseinfo.ulFlags.toString(16));

winrt.js

WinRT.Initialize

WinRT.Initialize(); // RO_INIT_MULTITHREADED

WinRT.ActivateInstance

var coreApplication = WinRT.GetActivationFactory("Windows.ApplicationModel.Core.CoreApplication", ICoreImmersiveApplication);
var mainView = new COM.Pointer(ICoreApplicationView);
ThrowIfFailed(coreApplication.get_MainView(mainView.GetAddressOf()));

WinRT.TypedEventHandler

TODO

WinRT.EventRegistrationToken

TODO

com.js

COM.Initialize

Initialize COM (CoInitialize)

COM.Initialize(COM.ApartmentType.STA);

COM.CreateInstance

Create objects with defined interfaces.

var IFileDialog = new COM.Interface(COM.IUnknown, {
	Show: [0, ['uint']],
	SetOptions: [6, ['uint']],
	GetResult: [17, ['pointer']],
}, "42f85136-db7e-439c-85f1-e4075d135fc8");
var modalWindow = COM.CreateInstance(CLSID_FileOpenDialog, COM.ClassContext.InProc, IFileDialog);

COM constants

Misc COM constants, enums and interfaces:

COM.S_OK
COM.S_FALSE
COM.E_NOINTERFACE
COM.ApartmentType.STA // or MTA
COM.ClassContext.InProc // or Local

COM.IUnknown
COM.IInspectable

COM Flow control

if (COM.Succeeded(CallSomeComApi())) {
	// call succeeded.
}


if (COM.Failed(CallSomeComApi())) {
	// call failed.
}


COM.ThrowIfFailed(CallSomeComApi());
// call succeeded.

COM.Pointer

var shellItem = new COM.Pointer(IShellItem);
COM.ThrowIfFailed(modalWindow.GetResult(shellItem.GetAddressOf()));

COM.Interface

var IFileDialog = new COM.Interface(COM.IUnknown, {
	Show: [0, ['uint']],
	SetOptions: [6, ['uint']],
	GetResult: [17, ['pointer']],
}, "42f85136-db7e-439c-85f1-e4075d135fc8");

var ICoreApplicationView = new COM.Interface(COM.IInspectable, {
	get_CoreWindow: [0, ['pointer']],
}, "638BB2DB-451D-4661-B099-414F34FFB9F1");

COM.RuntimeComObject

// Build a callback object.
var dispatcherFrame = new COM.RuntimeObject(IDispatchedHandler.IID);
// HRESULT IDispatchedHandler.Invoke(void);
dispatcherFrame.AddEntry(function (this_ptr) { callback(); return COM.S_OK; }, 'uint', ['pointer']);

ThrowIfFailed(coreDispatcher.RunAsync(CoreDispatcherPriority.Normal, dispatcherFrame.GetAddress(), Memory.alloc(Process.pointerSize)));

hstring.js

Read and write HSTRING data:

var hstr = HSTRING.alloc("plain text");
var hstrStringText = HSTRING.read(hstr);

bstr.js

Read and write BSTR data:

var bstr = BSTR.alloc("plain text");
var bstrStringText = BSTR.read(bstr);
BSTR.free(bstr);