MKI_RESULT_* (Operation Result) New in Version 2022.1

The result of an operation, enumeration or output. It indicates various types of errors, problems, and warnings that may have occurred but might not have caused the process to fail completely.

If the lowest 8 bits (MKI_RESULTMASK_ERROR) are zero, the operation was basically successful. Additional bits may however be set to indicate problem reports (MKI_RESULTMASK_PROBLEM), warnings (MKI_RESULTMASK_WARNING), and custom feedback flags (MKI_RESULTMASK_CUSTOM). It is on you to decide whether the overall operation was successful for your specific context.

Success (value 0)

MKI_RESULT_OK

The operation was basically successful.

Basic Errors (values 1 to 255)

MKI_RESULT_ERROR

Error: Unspecified error.

MKI_RESULT_STOPPED

Error: The operation was stopped (e.g. because the callback procedure returned false).

MKI_RESULT_NOTHING

Error: The operation yielded no output or had nothing to do.

MKI_RESULT_PARAMETER

Error: The operation was not started due to invalid parameters.

MKI_RESULT_MEMORYFULL

Error: The operation was cancelled since memory ran out.

MKI_RESULT_DISKFULL

Error: The operation was cancelled since disk space ran out.

MKI_RESULT_IDENT

Error: A wrong type of entity or object (or none at all) was identified.

MKI_RESULT_INVALID

Error: Invalid data was provided as input.

MKI_RESULT_TYPE

Error: The operation was not possible with the identified type of entity or object.

MKI_RESULT_IMPOSSIBLE

Error: With the given input and identification, no possible result exists.

MKI_RESULT_COMPLEX

Error: With the given input and identification, the calculation would be too complex (e.g. due to buffer or value range overflow).

Problem Reports (bits 8 to 27)

MKI_RESULT_LIBRARY_MISSING

Problem: At least one requested library is missing.

MKI_RESULT_BLOCK_MISSING

Problem: At least one requested block is missing.

MKI_RESULT_REFERENCE_MISSING

Problem: At least one requested drawing reference is missing.

MKI_RESULT_BITMAP_MISSING

Problem: At least one requested bitmap is missing.

MKI_RESULT_FONT_MISSING

Problem: At least one requested font is missing.

MKI_RESULT_PLUGIN_MISSING

Problem: At least one requested plug-in is missing.

MKI_RESULT_PDF_INTERFACE

Problem: Unable to access PDF interface.

MKI_RESULT_PDF_LIBRARY

Problem: Unable to access PDF library.

MKI_RESULT_UNLICENSED

Problem: CAD6 not licensed, a watermark will occur.

MKI_RESULT_INACCURATE

Problem: The result is inaccurate.

MKI_RESULT_INCOMPLETE

Problem: The result is incomplete.

Warnings (bits 28 to 47)

MKI_RESULT_UNDERLINE

Warning: Underlining of text was ignored, usually because text was revolved into surfaces or separate outline objects (where underlining is not supported).

MKI_RESULT_STRIKEOUT

Warning: Striking-out of text was ignored, usually because text was revolved into surfaces or separate outline objects (where striking-out is not supported).

MKI_RESULT_OPACITY

Warning: An opacity of less than 100% might not work on Windows printers or when exporting to WMF/EMF, or will be roughly approximated by Windows.

MKI_RESULT_RGBCOLOR

Warning: RGB color used where CMYK or Grayscale would be better.

Custom Reports (bits 48 to 63)

MKI_RESULT_CUSTOM1

MKI_RESULT_CUSTOM2

         ...

MKI_RESULT_CUSTOM15

MKI_RESULT_CUSTOM16

Custom flags 1 through 16, predefined for your convenience.

Masks used to differentiate the different types of results

MKI_RESULTMASK_ERROR

All bits that indicate errors (bits 0 to 7).

MKI_RESULTMASK_PROBLEM

All bits that indicate problems (bits 8 to 27)

MKI_RESULTMASK_WARNING

All bits that indicate warning (bits 28 to 47).

MKI_RESULTMASK_CUSTOM

All bits that indicate custom results, i.e. result bits that are available for custom use (bits 48 to 63).