Environment configurations, Al_loadenvironment – Measurement Computing ADLIB WIN User Manual
Page 35

Chapter 9 Environment Configurations
9-1
9. ENVIRONMENT CONFIGURATIONS
Each time the ADLIB library is to be used, the Environment configuration must be loaded and when all
devices have been released the Environment must be released. The AL_LoadEnvironment function loads
the information specified in the configuration file (.CON) that specifies the path to the initialization file
(.INI) and the boards installed in the system. Both (.CON) and (.INI) files are created with ADACCONFIG
utility.
9.1 AL_LoadEnvironment
Prototype
C\C++
ERRNUM
AL_LoadEnvironment(LPSTR
lpstrEnvInfoSource);
Visual Basic for Windows
Function
AL_LoadEnvironment(ByVal
lpstrEnvInfoSource As String) As Long
LPSTR lpstrEnvInfoSource
address of the ADLIB environment filename.
The AL_LoadEnvironment function loads the ADLIB environment configuration file. This file contains
the environment specific settings and the board(s)' related initialization information required for the proper
operation of the ADLIB.
Parameter
Description
lpstrEnvInfoSource
Points to a null-terminated string that names the complete drive, path,
and filename of the ADLIB configuration file (adlib.con). If this
parameter does not contain the full drive and path, ADLIB searches
the
Windows
directory.
Returns:
On success ERRNUM is set to 1, otherwise ERRNUM contains the last error code that occurred during the
call.
Related Functions:
AL_ReleaseEnvironment
Comments:
The application must call this function before attempting to make any ADLIB API function calls.
Program References:
All Examples
Supported Boards:
All