Your browser does not allow scripts
Please click here to view a static table of contents without scripts
DS1M12_GetDeviceSerialNumber
Return to Introduction  Previous page  Next page
This function returns the serial number of the specified DS1M12 connected to a system.

DS_STATUS
DS1M12_GetDeviceSerialNumber
(DWORD dwSerialNumberIndex, LPSTR lpSerialNumberBuffer, DWORD dwBufferSize)




Parameters

dwSerialNumberIndex
Index of the DS1M12. Use the DS1M12_GetNumDevices function call to get the number of available DS1M12s connected to a system. Example: if the number of DS1M12s returned is 2, then valid index values will be 0 and 1.
lpSerialNumberBuffer
Pointer to buffer that receives the serial number of the specified DS1M12. The string will be NULL terminated.
dwBufferSize
Length of the buffer created for the serial number string. Set buffer length to a minimum of 50 characters.




Return Value
Returns DS_SUCCESS if successful, otherwise the return value will be one of the following error codes:

   DS_DEVICE_NOT_FOUND
   DS_INVALID_SERIAL_NUMBER_INDEX
   DS_NULL_SERIAL_NUMBER_BUFFER_POINTER
   DS_SERIAL_NUMBER_BUFFER_TOO_SMALL
   DS_IO_ERROR