Error handling functions, Al_seterronreinitrunning – Measurement Computing ADLIB WIN User Manual
Page 145

Chapter 42 Error Handling Functions
29-1
29. ERROR HANDLING FUNCTIONS
The Error Handling functions allow the user to determine when a specific error should or should not occur.
In addition the current status of a device may be obtained.
29.1 AL_SetErrOnReInitRunning
Prototype
C\C++
ERRNUM
AL_SetErrOnReInitRunning(LHLD
lhld, long lState);
Visual Basic for Windows
Function
AL_SetErrOnReInitRunning(ByVal
lhld As Long,
ByVal lState As Long) As Long
LHLD lhld
handle of the LDSD
long lState
specifies the re-initialization state
The AL_SetErrOnReInitRunning function sets the hardware re-initialization authorization of the LDSD.
Essentially this function affects whether the AL_InitDevice function is allowed to initialize a hardware
device while the device itself is in a running state.
Parameter
Description
lhld
Identifies the instance of the logical device subsystem.
lState
Specifies the re-initialization authorization state of the LDSD. The available
settings are defined in the ADLIB include file as follows:
•
“ALLOW_REINIT”
The device will first be stopped and then
reinitialized
to
the
current
settings.
•
“DISALLOW_REINIT“
Reinitialization of the device will not be
allowed when the device is running and will
return
an
error.
Returns:
On success ERRNUM is set to 1, otherwise ERRNUM contains the last error code that occurred during the
call.
Supported Logical Device Subsystems:
All Boards