GetAllSettings 함수

아티클
08/20/2008

업데이트: 2007년 11월

Windows 레지스트리에 있는 응용 프로그램 엔트리에서 키 설정 및 해당 값(원래 SaveSetting으로 만든 값)의 목록을 반환합니다.

My 기능을 사용하면 GetAllSettings를 사용할 때보다 레지스트리 작업에서 생산성과 성능이 향상됩니다. 자세한 내용은 My.Computer.Registry 개체를 참조하십시오.

Public Function GetAllSettings( _
ByVal AppName As String, _ 
ByVal Section As String _
) As String(,)

매개 변수

AppName
필수적 요소. 키 설정이 요청된 응용 프로그램이나 프로젝트의 이름을 포함하는 String 식입니다.
Section
필수적 요소. 키 설정이 요청된 섹션의 이름이 포함된 String 식입니다. GetAllSettings는 2차원 문자열 배열을 포함하는 개체를 반환합니다. 이 문자열은 지정된 섹션의 모든 키 설정과 이 설정에 해당하는 값을 포함합니다.

예외

예외 형식	오류 번호	조건
ArgumentException	5	사용자가 로그인하지 않았습니다.

비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.

설명

AppName과 Section 중 하나가 없으면 GetAllSettings는 초기화되지 않은 Object를 반환합니다.

GetAllSettings는 사용자가 대화형으로 로그온해야 활성화되는 HKEY_LOCAL_USER 레지스트리 키 아래서 작동하기 때문에 로그온해야 사용할 수 있습니다.

Mtx.exe 같이 대화형이 아닌 프로세스에서 액세스할 레지스트리 설정은 HKEY_LOCAL_MACHINE\Software\ 또는 HKEY_USER\DEFAULT\Software 레지스트리 키 아래 저장해야 합니다.

예제

다음 예제에서는 먼저 SaveSetting 함수를 사용하여 Windows 레지스트리에 AppName으로 지정된 응용 프로그램에 대한 엔트리를 만든 다음, GetAllSettings 함수를 사용하여 해당 설정을 표시합니다. GetAllSettings로는 응용 프로그램과 Section 이름을 검색할 수 없습니다. 마지막으로 DeleteSetting 함수를 사용하여 응용 프로그램 엔트리를 제거합니다.

' Object to hold 2-dimensional array returned by GetAllSettings.
' Integer to hold counter.
Dim MySettings(,) As String
Dim intSettings As Integer
' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
' Retrieve the settings.
MySettings = GetAllSettings("MyApp", "Startup")
For intSettings = LBound(MySettings, 1) To UBound(MySettings, 1)
   WriteLine(1, MySettings(intSettings, 0))
   WriteLine(1, MySettings(intSettings, 1))
Next intSettings
DeleteSetting("MyApp")