RecentError

Return the contents of the recent error string

Description:

This is a USBm.dll function that returns a string with error information.

Command Syntax:

true⁄false USBm_RecentError( string )

The USBm_RecentError function syntax has these parts:

Part	Description
string	Any valid string expression.

Remarks:

In VB the string passed as an argument must be large enough to hold all the characters that the function places in the string. The best way to achieve this is to set the string to a large size with the String function as in this code:

strStrng = String(250, ” “)

Note: USBm_RecentError always returns TRUE.

Note: USBm_RecentError does not affect the internal error string.

VB Declaration (USBmAPI.bas)

Public Declare Function USBm_RecentError _
    Lib “USBm.dll” _
        (ByVal errorstring As String) _
    As Integer

VB Example

Dim strng As String * 255

USBm_RecentError strng
frmStatus.lstDevices.AddItem “About the USBm DLL: ” & strng

This code fragment shows that strng is loaded with the “error” text of the DLL. Assuming that the form called “Main” exists with a text box called “Info”, the “error” information will be made visible to the user.

C Prototype

int USBm_RecentError( char *errorstring );

C Example

RobotBASIC

Recent Error and Debug String are handled by the RobotBASIC function usbm_ErrorSpecs().

usbm_ErrorSpecs()

Returns a string that contains information about the recent error string and the debug string if any in the DLL. There are two sections separated by the | character. You can use the Extract() function to extract each section separately if desired. The sections are:

Recent Error

Debug String