There are some hidden features in easyConverter that advanced users can take advantage of.
Multiple input files can be specified after the
-in switch. For example:
beconv -in a.pdf b.pdf c.pdf
In this example, all three input files will be converted. The output file names are automatically chosen as a.docx, b.docx and c.docx.
You may also use wild chars, such as *:
beconv -in *.pdf
Since switches begin with a dash, when the first character of a file name is a dash, it may confuse easyConverter. For example:
beconv -in a.pdf -b.pdf
The problem here is that
-b.pdf is an
invalid switch, which causes an error message. You can work around
this issue in two ways:
-inswitch. The first parameter after
-inis always treated as a filename:
beconv -in a.pdf -in -b.pdf
The way output file names are automatically calculated is by
changing the extension of the input file name. For example, a.pdf
will become a.docx by default. The extension depends on
You can use the
-out switch to specify
your preferred output file name.
beconv -in input.pdf -out -output.doc
If there are any
-out switches, you
must have an equal number of input and output file names.
For example, this is invalid, because it would be very confusing:
beconv -in a.pdf b.pdf -out -output.doc
Automatic output file naming is only available when there are no
-out switches at all.
Note that explicitly specifying an output file extension also changes the file type, as long as the extension is .doc, docx or .rtf.
beconv -in a.pdf b.pdf -out a.doc b.docx
In other words, when the extension is recognized, the
-output switch is ignored.
However, when the extension is unknown, the
-output switch is meaningful:
beconv -output doc -in input.pdf -out output.bin
If your input PDF is password-protected,
-password must be specified, which applies to all
input files at the same time.
Also note that depending on the PDF's internal restrictions, easyConverter may refuse to accept the open password. If you do not have Extraction privileges, you cannot convert your PDF.
The command-line tool returns 0 on success (including when warnings are displayed), and a positive integer on error (when the operation could not be completed).
Error codes 1 - 19 are the same in all BCL Technologies command-line SDKs. Values 20 and higher are unique to each specific product or API.
easyConverter Word error codes:
|0||Success||Operation completed successfully. Warning may or may not be present.|
|1||Invalid parameter||One or more parameters were invalid|
|2||License problem||Invalid license; license or evaluation expired; the feature you are trying to use is not enabled with the license you have|
|3||Cannot open input||Input file name is invalid; file does not exist; network is unavailable; drive was ejected; not enough permissions to access the input file.|
|4||Cannot create output||Output file name is invalid; network is unavailable; drive was ejected or full; another application has opened the same file; not enough permission to create the output file.|
|5||Invalid input||Input file exists, but it is invalid. Usually indicates an invalid or corrupt PDF, or any other input file parsing problem, other than password problems.|
|6||Invalid output||Output file was created, but it is invalid. There were some problems, such as fonts could not be embedded, some issues that make the output corrupt.|
|7||Encrypted input||Input file is encrypted, and there is no password, or the password is invalid, or the password does not give permission to complete the requested operation.|
|8||Timeout||The whole or part of the operation has timed out. You may get better luck by increasing the timeout, because some operations take a lot of time to complete.|
|9||Canceled||The operation has been canceled. This is very unlikely in an SDK, which has no user interaction. A callback may cancel programmatically, but the command-line SDK has no callbacks. So this is not expected to happen.|
|10||Access denied||Temporary file could not be created; registry could not be accessed; any other system-level denial of access. Exception: if the input or output file cannot be accessed, the error codes 3 and 4 are used instead.|
|17||Invalid setup||The product is not set up correctly. Files or registry got corrupted. Please reinstall.|
|18||Out of memory||There was not enough memory to complete the operation. Note: it is not guaranteed that you get this error when you run out of memory. You could also get 19 - Internal error.|
|19||Internal error||Invalid operation; unknown error; crash; access violation.|
|20||Page too large||PDF page is too large for Word.|
|21||Word automation error||Error when converting from RTF to DOC/DOCX using Microsoft Word automation.|