Environment configurations, Al_loadenvironment – Measurement Computing ADLIB WIN User Manual

Page 35

Advertising
background image

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

Advertising