cbGetBoardName()

Returns the board name of a specified board, or iterates through a list of all supported boards.

Function Prototype

C/C++

int cbGetBoardName(int BoardNum, char *BoardName)

Visual Basic

Function cbGetBoardName(ByVal BoardNum&, ByVal BoardName$) As Long

Arguments

BoardNum

The number associated with the board when it was installed with InstaCal or created with cbCreateDaqDevice(). In this case, BoardNum may be 0 to 99. It can also refer to the list of supported boards by using GETFIRST, or GETNEXT.

BoardName

A null-terminated string variable that the board name will be returned to. This string variable must be pre-allocated to be at least as large as BOARDNAMELEN. This size is guaranteed to be large enough to hold the longest board name string. Refer also to the board type codes in the "Measurement Computing Device IDs" section.

Returns

• Error code or 0 if no errors.
• BoardName – return string containing the board name.

Notes

There are ways of using this function:

• Pass a board number as the BoardNum argument. The return string describes the type of the installed board.
• Set BoardNum to GETFIRST or GETNEXT to get a list of all board types that are supported by the library. Set BoardNum to GETFIRST to get the first board type in the list of supported boards. Subsequent calls with Board=GETNEXT returns each of the other board types supported by the library. When you reach the end of the list, BoardName is set to an empty string. Refer to the ulgt04 example program for more details.