Al_getboardstring – Measurement Computing ADLIB WIN User Manual
Page 44

Chapter 10 Board Functions
10-4
10.4 AL_GetBoardString
Protype
C\C++
ERRNUM
AL_GetBoardString(BRDID brdid, LPSTR lpstr, long lMaxLength);
Visual Basic for Windows
Function
AL_GetBoardString(ByVal
brdid As Long, ByVal lpstr As String,
ByVal lMaxLength As Long) As Long
BRDID brdid
ID number of the board
LPSTR lpstrBrd
destination address
long lMaxLength
the count in bytes to be copied
The AL_GetBrdString function copies lMaxLength bytes for the ADLIB board string to the destination
string. If the size of the destination string length is less than the string to be copied, the resulting string will
be truncated and NULL padded.
Parameter
Description
brdid
Specifies the ID number of the board from which the board driver’s software
version number is to be retrieved.
lpstrBrd
Points to the input destination string.
lMaxLength
Maximum length in bytes to be copied to the user string, including the NULL
termination
character.
Returns:
On success ERRNUM is set to 1, otherwise ERRNUM contains the last error code that occurred during the
call.
Related Functions:
AL_SetBoardString
Program References:
NONE
Supported Boards:
All