VB.NET Language in a Nutshell, Second Edition

Name

GetAllSettings Function

Class

Microsoft.VisualBasic.Interaction

Syntax

GetAllSettings(appname, section)

appname (required; String)

Name of the application

section (required; String)

Relative path from appname to the key containing the settings to retrieve

Return Value

An object containing a two-dimensional array of strings

Description

Returns the registry value entries and their corresponding values for the application

Rules at a Glance

• GetAllSettings works exclusively with the subkeys of HKEY_CURRENT_USER\ Software\VB and VBA Program Settings.

• The elements in the first dimension of the array returned by GetAllSettings contain the value entry names.

• The elements in the second dimension of the array returned by GetAllSettings contain the values for the respective value entries.

• The two-dimensional array returned by GetAllSettings is based at 0 (as are all arrays) so the first value entry name is referenced using (0,0).

• A call to GetAllSettings will return only the value entry names and data belonging to the final registry key specified by the section argument. If that key itself has one or more subkeys, their data will not be retrieved by the function.

• If either appname or section do not exist, GetAllSettings will return an uninitialized Object.

Programming Tips and Gotchas

• GetAllSettings is a function that was developed to retrieve data from initialization files in 16-bit environments and to retrieve data from the registry under Windows 9x and Windows NT. The language of the documentation, ...