Retrieve a string value from the profile using the supplied subkey for the given Driver ID and variable name. Set and return the default value if the requested variable name has not yet been set.

Namespace: ASCOM.Utilities.Interfaces
Assembly: ASCOM.Utilities (in ASCOM.Utilities.dll) Version: 6.0.0.0 (6.1.1.2619)

Syntax

C#
string GetValue(
	string DriverID,
	string Name,
	string SubKey,
	string DefaultValue
)
Visual Basic
Function GetValue ( _
	DriverID As String, _
	Name As String, _
	SubKey As String, _
	DefaultValue As String _
) As String
Visual C++
String^ GetValue(
	String^ DriverID, 
	String^ Name, 
	String^ SubKey, 
	String^ DefaultValue
)

Parameters

DriverID
Type: System..::..String
ProgID of the device to read from
Name
Type: System..::..String
Name of the variable whose value is retrieved
SubKey
Type: System..::..String
Subkey from the profile root from which to read the value
DefaultValue
Type: System..::..String
Default value to be used if there is no value currently set

Return Value

Retrieved variable value

Remarks

Name may be an empty string for the unnamed value. The unnamed value is also known as the "default" value for a registry key.

Does not provide access to other registry data types such as binary and doubleword.

If a default value is supplied and the value is not already present in the profile store, the default value will be set in the profile store and then returned as the value of the DriverID/SubKey/Name. If the default value is set to null (C#) or Nothing (VB) then no value will be set in the profile and an empty string will be returned as the value of the DriverID/SubKey/Name.

See Also