Diagnostic

Description

Obtains the diagnostic string of the specified card, giving expanded information on any fault conditons indicated by the PIPLX_Status value.

Prototype

DWORD PIPLX_Diagnostic(SESSION session, DWORD CardNum, CHAR *Str);

Parameters:

Session - The session variable obtained from the PICMLX_Connect call

CardNum - card number

Str - pointer to character string to receive the result

Returns:

Zero for success, or non-zero error code.

Notes

The result string may include embedded newline characters, coded as the ASCII <linefeed> character ('\x0A').

The length of the result string will not exceed the value of the driver constant MAX_DIAG_LENGTH.

Warning

Formatting and content of the diagnostic string may change as enhanced diagnostic features are made available. It should therefore not be interpreted programatically.