PDL_GetDeviceName
Description
Sets the passed buffer variable with the device's name. This is the value of the Name field that appears when you open the Device Info app on the device. Note that, since this is a user-entered field, it is not necessarily a unique device identifier. Use PDL_GetUniqueID
to get a unique device identifier.
Syntax
PDL_Err PDL_GetDeviceName(char *buffer, int bufferLen);
Argument | Description |
---|---|
buffer | Pointer to the buffer. The buffer should be at least 64 bytes long, though not all of it is necessarily used. |
bufferLen | Length of the buffer. |
Returns
PDL_EOTHER — Unable to get the device name. PDL_INVALIDINPUT — Buffer is empty or null. PDL_SYSTEMERROR_FILE — Unable to access preferences database. PDL_STRINGTOOSMALL — Buffer is too small to hold device name. PDL_NOERROR — Success.