Unigraf UCD-240, Руководство пользователя

Страница: 71 / 78

UCD Console for UCD-340 User Manual | Unigraf Oy
71.
(...Continued)
oErrorCode
Reference to a variable that receives an error code. Error codes are non-
zero negative values. Zero (and positive values) indicate no error result.
oErrorMsg
Pointer to the first byte of a 1024 byte character array which receives a
human readable error message if the function failed. If there were no errors,
the resulting error message is empty.
Result
If the function succeeds, the error flag is set to “false”, Error code and Error message are
cleared. If the function fails, the error flag is set to “true”, Error code and Error message
variables are set to indicate the error.
TSI_TST_RunTest
ClientVersion 12, and higher No license requirements
void __cdecl TSI_TST_RunTest
(
char *Device,
char *ConfigScript,
int TestID,
bool &Passed,
bool &Error,
char oErrorMsg[1024],
char oReportText[64000]
);
Description
The function runs the test indicated by TestID value. The test is executed on a hardware unit
indicated by the Device value. Before the test is started, any script given in ConfigScript is
executed. If the test passes, the Passed is set to true, and otherwise false. If the function
encounters any errors, the Error flag is set to true. If Error flag is set to true, the oErrorMsg
will contain a human readable error message. oReportText will contain test log as human
readable text data.
Parameters
Device
Pointer to a string containing the name of the device which is to run the
test. The device names are user defined in the initialization script at the
time TSI_TST_Init was called.
ConfigScript
Pointer to a test configuration script. If the device is already configured this
script can be empty. The script can be directly passed as string, or it can be
a file-name from which the script is loaded.
(Continued...)