DeviceExistsAddressFull

Purpose

This function indicates if the device does or does not exist using its full Address-Code value (See also DeviceExistsAddress, DeviceExistsCode)

Parameters

Parameter: Address
Type: string
Description: This is the device address with code, such as "Unit1-R66", "0F47ED78-2", or "U2-I45-K2.2-Y55"

Parameter: CaseSensitive
Type: Boolean
Description: When True, the address-code must match exactly. When false, the address-code match is case insensitive such that apple2-Y65=APPLE2-y65

Returns

Return value: status
Type: Integer
Description: Returns -1 if the device does not exist, otherwise it returns the device reference ID number of the device. The reference number can then be used with the GetDeviceRef function.

Example

Sample Code

VB

None

Notes

The address field can contain any string of characters. The format and value is determined by a plug-in in the event that the device is owned by a plug-in.
When retrieved, the Address property includes the Code property, separated by a dash (-) if the Code property is set. For example, if the Address was set to "Unit1" and the code field is not used, then retrieving the Address field will result in "Unit1". If the Address was set to "Unit1" and the code was set to "Y55", then retrieving the Address field will result in "Unit1-Y55".
When this function is used, the Code field is combined with the Address field. (See DeviceExistsAddressl to find a device using its address value only.)