nsdsp_list_get_serial

This function returns the serial number for one of the NSDSP programmers in the NSDSP List object.

Syntax

int nsdsp_list_get_serial(
        nsdsp_list_t      list,
        int               index,
        char*             serial
);

Parameters

list - a reference to the list of NSDSP programmers returned by the nsdsp_list_create function

index - a zero based index to select the programmer.

serial - the buffer to be filled with the serial number. The buffer must be at least 32 characters long.

Return

The function returns non-zero if the serial number has been filled in, or zero if the index is out of range.

Notes

You can use the serial number to connect to the NSDSP programmer of your choice using nsdsp_connect function.

On Windows, there are two versions of this function - nsdsp_list_get_serial_a (for ASCII) and nsdsp_list_get_serial_w (for UNICODE). The "nsdspif.h" file maps nsdsp_list_get_serial to one of these functions depending on whether UNICODE is defined or not.

 

Minimum library version - 163