Al_getboardname – Measurement Computing ADLIB WIN User Manual

Page 45

Advertising
background image

Chapter 10 Board Functions

10-5

10.5 AL_GetBoardName

Protype

C\C++

ERRNUM

AL_GetBoardName(BRDID brdid, LPSTR lpstr, long lMaxLength);


Visual Basic for Windows

Function

AL_GetBoardName(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_GetBrdName 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:
NONE

Program References:
NONE

Supported Boards:
All

Advertising