3. Integration

Owned by Andy Erd
Mar 30, 2022

General

StepOver signature device driver can be controlled with the help of API, which is available as different components.

Important

To use (our) OCX and DLL you must call CoInitialize(NULL) and the corresponding CoUninitialize; to initialize the COM / DOM Subsystem of windows.

See https://msdn.microsoft.com/query/dev14.query?appId=Dev14IDEF1&l=DE-DE&k=k(CoInitialize);k(DevLang-C%2B%2B);k(TargetOS-Windows)&rd=true

In the Header Section of your application

#include "objbase.h"

Before using functions out of our DLL/OCX call, check the return-value and if no error preceed.

CoInitialize(NULL);

Do function calls to out DLL/OCX

At End of your application, after the last call to our DLL/OCX (after Unload DLL) you should call

CoUninitialize;

 

 

 

Manifest file

if you want to run your application without registering our activeX components, you will need to declare a manifest file for the executable.

For e.g. your application is called "SignerApp.exe" then you will need a manifest file with the filename "signerApp.exe.manifest" in the same directory as your application.

The content of the manifest file is same as the following example, except the path to the ActiveX components - this must be adjusted by you appropriate to your directory structure.

Example Manifest file
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <dependency>
   <dependentAssembly>
     <assemblyIdentity
       type="win32"
       name="Microsoft.Windows.Common-Controls"
       version="6.0.0.0"
       publicKeyToken="6595b64144ccf1df"
       language="*"
       processorArchitecture="*"/>
   </dependentAssembly>
 </dependency>
 <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
   <security>
     <requestedPrivileges>
       <requestedExecutionLevel
         level="asInvoker"
         uiAccess="false"/>
       </requestedPrivileges>
   </security>
 </trustInfo>
  <description>Your Project name</description>
  <file name="stepover\StepOverRegisterEngine.ocx">
    <comClass clsid="{6F59B8BE-D746-47AD-AE33-095E097F50A3}"
    progid="StepOverRegisterEngine.SORegister" threadingModel="Apartment"/>
  </file>
  <file name="stepover\StepOverSignatureAPI4.ocx">
    <comClass clsid="{175B71A7-81A1-4BED-A435-A6B88CF782B2}"
    progid="StepOverSignatureAPI4.StepOverSignatureAPIv4" threadingModel="Apartment" />
  </file>
    <file name="stepover\driver\StepOverSignatureDevice1.ocx">
    <comClass clsid="{F5C74079-C195-4DA9-B60D-F6F5365042D1}"
    progid="StepOverSignatureDevice1.StepOverSignatureDevice" threadingModel="Apartment" />
  </file>
  </assembly>