Narcissistic Preening Monarch
    Have ideas to improve npm?Join in the discussion! »

    node-dcom

    1.0.9 • Public • Published

    node-dcom

    node-com is a partial DCOM-compatible lib for Node.js environment. Most of the implementation do not follow the official specification so not all the protocol features are supported. This was implemented as a part of our OPC-DA node for Node-RED so features were implemented as they were needed for what we wanted to achieve with that node. Most of the code base is a NodeJS implementation of the J-Interop Java library.

    This node was created by Smart-Tech as part of the ST-One project.

    Table of Contents

    Install

    Using npm:

    npm install node-dcom
    

    Creating a Session

    To create a session you will need the following information from the server: user name, password, and domain. In the example we call createSession :

    let session = new Session();
    session = session.createSession(domain, username, password);

    By default the global timeout is set to 0 so you should also set the correct connection timeout according to how you network behaves. If no values are defined for the timeout or if the value is too low for the average response time of your connection you'll be able to create a session but the next step (creating a server) will have frequent timeouts.

    session.setGlobalSocketTimeout(timeout);

    Creating a Server

    Now that you've already created a session you can create a server reference. To create this you'll need the ClassID of the server you want to connect and it's IP address. With those at hand you create a clsid object and pass it as one of the parameters for the server:

    let Clsid = new Clsid(ClassID);
    let comServer = new ComServer(Clsid, address, session);
    comServer.init();

    With that the server will create an endpoint that will be attached to the given address, authenticate, and will issue an activation request. To be able to query object on this server you'll have to create create a COM Object reference for the server:

    let server = comServer.getInstance();

    Creating a COM Object

    WIth both the session and server instance created you can finally create a COM Object. For this we'll use the queryInterface function giving the ClassID (here you can give the string) of the desired object as an argument.

    server.queryInterface(ClassID);

    Destroying a Session

    To release all the objects created in a given session call the function destroySession().

    session.destroySession(session);

    Contributing

    This is a partial implementation and there are lots that could be done to improve what is already supported or to add support for more DCOM features. Feel free to dive in! Open an issue or submit PRs.

    License

    Copyright 2017 Smart-Tech, Apache 2.0 license.

    Install

    npm i node-dcom

    DownloadsWeekly Downloads

    313

    Version

    1.0.9

    License

    Apache-2.0

    Unpacked Size

    522 kB

    Total Files

    111

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar