TBApiApply API Call

 

Description

Some API calls change settings, but do not store them until the user calls TBApiApply or TBApiApplyNoReload.

Parameters

None.

Returns

0 = fail, 1 = OK.

Notes

1.        If a real change (as opposed to an operation that retains the current setting) is detected, the driver is re-initialised. All connections are re-established.

2.        Prior to calling TBApiApply, API calls that read values will return any changed data held in memory not the saved value in tbupdd.ini.

3.        See TBApiApplyNoReload if driver reinitialisation is not required.

4.        API calls that update settings should make one of these calls to apply settings.

See also

TBReloadNoApply – Reloads the driver without applying changes.

 

Visual C++ Declaration/example

 

BOOL TBAPI TBApiApply();

 

If ( !TBApiApply() )

            AfxMessageBox(“Failed to apply configuration changes to driver”)

 

Visual Basic Declaration/example

 

Public Declare Function TBApiApply Lib "TBapi" Alias “_DLL_ TBApiApply@0" () As Boolean

 

If TBApiApply = False then

            MsgBox  “Failed to apply configuration changes to driver”

End If