IProfileRegisteredDevices Method

List the devices of a given device type that are registered in the Profile store

Definition

Namespace: ASCOM.Utilities.Interfaces
Assembly: ASCOM.Utilities (in ASCOM.Utilities.dll) Version: 7.1.3+4851.c5da65c2b

C#

ArrayList RegisteredDevices(
	string DeviceType
)

VB

Function RegisteredDevices ( 
	DeviceType As String
) As ArrayList

C++

ArrayList^ RegisteredDevices(
	String^ DeviceType
)

Parameters

DeviceType String: Type of devices to list

Return Value

ArrayList
An ArrayList of KeyValuePair objects of installed devices and associated device descriptions

Remarks

Use this to find all the registered devices of a given type that are in the Profile store.

If a DeviceType is supplied, where no device of that type has been registered before on this system, an empty list will be returned

Platform 6 Profile.RegisteredDevices was introduced in Platform 5.5 as a read only property that took DeviceType as a parameter, which is legal syntax in Visual Basic .NET but is not interpreted correctly in C#. Consequently, a breaking change has been introduced in Platform 6 that changes the property into a parameterised method which works correctly in all .NET languages.

This change does not require you to alter your source code but you may need to recompile your application under Platform 6 to ensure that there are no runtime errors.

Exceptions

InvalidValueException

Throw if the supplied DeviceType is empty string or null value.