Reference Guide

vConverter v4.1 Chapter 5 Using vConverter CLI 161
92BCommand Line Arguments
Running CLI Tool Executable
CLI Tool executable—vccli.exe—was primarily developed as a CLI utility for users who
want to automate the conversion process by running it from batch files or who want to
use it for testing. It is located in the vConverter installation folder. The format of calling
vccli.exe is:
vccli.exe <generic CLI Tool command line parameters>
The CLI Tool executable connects to a local vConverter License Service using a
customer’s existing serial number, read from the Windows registry, and decreases the
conversion counter of installed the vConverter package. The executable passes its output
into a standard console output stream. The CLI Tool executable does not work in auto-
trial mode. It requires proper activation.
Note: For the CLI Tool executable to run, it must be placed on the same system as the
license service.
146BRunning CLI Tool DLL
The CLI Tool DLL is the extension library used to incorporate the system conversion
functionality to third-party products. It is not bound to the internal vConverter license
engine. Rather, it is bound to the name of main executable file (returned by
GetModuleFileName() Win32 API call). It fails when the name does not match the initial
name hardcoded within the DLL in a crypted form.
These functions are exported by the CLI Tool DLL:
SetCallback(void * pfunc) Sets the callback pointer to receive progress
notifications. Progress notification string format
is described below.
Convert(LPCWSTR Arguments) Kicks off the conversion. Arguments are
184Hgeneric CLI Tool command line parameters.
BreakConversion(void) Immediately breaks the currently run
conversion.
The callback function prototype supplied in SetCallback() is defined as:
typedef void (__stdcall *PCallback)(LPCWSTR statusMessage);
statusMessage is a pointer to locally allocated wide char string buffer that contains the
status string in a brief or full (human-readable) format, depending on passed command
line parameters. The caller application must copy this string into its local buffer for
further usage and must not refer to the passed string address after returning from the
callback function call.