응용 프로그램 수준 추가 기능에 대한 레지스트리 항목
업데이트: 2007년 11월
적용 대상 |
|---|
이 항목의 정보는 지정된 Visual Studio Tools for Office 프로젝트 및 Microsoft Office 버전에만 적용됩니다. 프로젝트 형식
Microsoft Office 버전
자세한 내용은 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오. |
Visual Studio Tools for Office를 사용하여 만든 추가 기능을 배포할 때 특정 레지스트리 항목 집합을 만들어야 합니다. 이러한 레지스트리 항목은 Microsoft Office 응용 프로그램에서 추가 기능을 검색하고 로드할 수 있게 해 주는 정보를 제공합니다. 자세한 내용은 응용 프로그램 수준 추가 기능 아키텍처를 참조하십시오.
프로젝트를 빌드하면 추가 기능을 손쉽게 디버깅할 수 있도록 Visual Studio Tools for Office에서 배포 컴퓨터에 이러한 레지스트리 항목을 만듭니다. 자세한 내용은 Office 솔루션 빌드 프로세스 개요를 참조하십시오.
추가 기능을 배포할 때 최종 사용자 컴퓨터에 레지스트리 키를 만드는 방법에 대한 자세한 내용은 Office 솔루션 배포(2007 시스템) 및 응용 프로그램 수준 추가 기능 배포(2003 시스템)를 참조하십시오.
이 항목에서 add-in ID 텍스트는 추가 기능의 고유 ID를 나타냅니다. 기본적으로 이 ID는 추가 기능 프로젝트의 이름입니다.
2007 Microsoft Office System에 대한 레지스트리 항목
2007 Microsoft Office system에 필요한 추가 기능 레지스트리 항목은 Microsoft Office Visio를 제외한 모든 응용 프로그램의 경우 다음 레지스트리 키 아래에 있습니다.
HKEY_CURRENT_USER\Software\Microsoft\Office\application name\Addins\add-in ID
Visio의 경우 레지스트리 항목은 다음 레지스트리 키 아래에 있습니다.
HKEY_CURRENT_USER\Software\Microsoft\Visio\Addins\add-in ID
.gif "참고") 참고: |
|---|
2007 Microsoft Office system의 응용 프로그램에서는 HKEY_CURRENT_USER 아래에 등록된 Visual Studio Tools for Office 추가 기능만 인식합니다. 따라서 2007 Microsoft Office system용 Visual Studio Tools for Office 추가 기능을 HKEY_LOCAL_MACHINE 아래에 등록하는 방법으로 컴퓨터의 모든 사용자에게 해당 추가 기능을 배포할 수는 없습니다. |
다음 표에서는 이 레지스트리 키 아래에 추가해야 하는 항목을 보여 줍니다.
항목 |
형식 |
값 |
|---|---|---|
Description |
REG_SZ |
추가 기능의 간단한 설명 이 설명은 사용자가 Microsoft Office 응용 프로그램의 옵션 대화 상자에 있는 추가 기능 창에서 추가 기능을 선택할 때 표시됩니다. |
FriendlyName |
REG_SZ |
Microsoft Office 응용 프로그램의 COM 추가 기능 대화 상자에 표시되는 추가 기능의 서술적 이름이며, 기본값은 추가 기능 ID입니다. |
LoadBehavior |
REG_DWORD |
응용 프로그램에서 추가 기능을 로드할 시기와 추가 기능의 현재 상태(로드됨 또는 언로드됨)를 지정하는 값입니다. 기본적으로 이 항목은 시작 시 추가 기능이 로드되도록 지정하는 3으로 설정되어 있습니다. 자세한 내용은 LoadBehavior 값을 참조하십시오. |
Manifest |
REG_SZ |
추가 기능에 대한 배포 매니페스트의 전체 경로입니다. 이 경로는 로컬 컴퓨터, 네트워크 공유(UNC) 또는 웹 서버(HTTP)의 위치일 수 있습니다. 참고:
개발 컴퓨터에서 추가 기능을 빌드하면 Visual Studio Tools for Office에서는 이 레지스트리 항목에 |vstolocal 문자열(즉, 파이프 기호 | 뒤에 vstolocal)을 추가합니다. 이렇게 하면 개발 컴퓨터의 Visual Studio에서 추가 기능을 실행할 때 Visual Studio Tools for Office에서 추가 기능을 로드할 수 있습니다.
|
Outlook 양식 영역에 대한 레지스트리 항목
Microsoft Office Outlook 2007용 추가 기능에서 사용자 지정 양식 영역을 만들 경우 레지스트리 항목을 사용하여 양식 영역을 Outlook에 등록합니다. 이 레지스트리 항목은 다음 키 아래에 있습니다.
HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\FormRegions\message class
자세한 내용은 Specifying Form Regions in the Windows Registry를 참조하십시오. Outlook 양식 영역에 대한 자세한 내용은 Outlook 양식 영역 만들기를 참조하십시오.
Microsoft Office 2003에 대한 레지스트리 항목
Microsoft Office 2003에 필요한 추가 기능 레지스트리 항목은 다음 레지스트리 키 아래에 있습니다.
HKEY_CURRENT_USER\Software\Microsoft\Office\application name\Addins\add-in ID
HKEY_CURRENT_USER\Software\Classes\add-in ID\CLSID
HKEY_CURRENT_USER\Software\Classes\CLSID\{add-in CLSID}
HKEY_CURRENT_USER\Software\Classes\CLSID\{add-in CLSID}\InprocServer32
HKEY_CURRENT_USER\Software\Classes\CLSID\{add-in CLSID}\ProgID
HKEY_CURRENT_USER\Software\Classes\CLSID\{add-in CLSID}\Programmable
HKEY_CURRENT_USER\Software\Classes\CLSID\{add-in CLSID}\VersionIndependentProgID
| 참고: |
|---|
HKEY_CURRENT_USER 대신 HKEY_LOCAL_MACHINE 아래에 레지스트리 키를 만들어 컴퓨터의 모든 사용자가 Microsoft Office 2003용 Visual Studio Tools for Office 추가 기능을 사용할 수 있도록 설정할 수 있습니다. |
다음 단원에는 각 레지스트리 키 아래에 추가해야 하는 항목의 목록이 나와 있습니다. add-in CLSID 텍스트는 추가 기능의 CLSID(Globally Unique Class Identifier)를 나타냅니다. 추가 기능의 CLSID를 가져오려면 다음 위치 중 하나를 참조합니다.
추가 기능을 빌드할 때 개발 컴퓨터에 만들어진 HKEY_CURRENT_USER\Software\Classes\add-in ID\CLSID 레지스트리 항목의 기본값
.csproj(C#의 경우) 또는 .vbproj(Visual Basic의 경우) 프로젝트 파일의 ProjectGuid 요소
| 참고: |
|---|
Windows Vista에 Microsoft Office 2003 추가 기능을 배포하려면 다음 목록의 일부 레지스트리 항목을 다른 하위 트리에 만들어야 합니다. 자세한 내용은 Windows Vista의 Microsoft Office 2003 추가 기능에 대한 레지스트리 항목을 참조하십시오. |
HKEY_CURRENT_USER\Software\Microsoft\Office\<application name>\Addins\<add-in ID>
| 참고: |
|---|
Visio 추가 기능의 경우 HKEY_CURRENT_USER\Software\Microsoft\Visio\Addins\add-in ID 키를 사용합니다. |
항목 |
형식 |
값 |
|---|---|---|
Description |
REG_SZ |
추가 기능의 간단한 설명 |
FriendlyName |
REG_SZ |
Microsoft Office 응용 프로그램의 COM 추가 기능 대화 상자에 표시되는 추가 기능의 서술적 이름이며, 기본값은 추가 기능 ID입니다. |
LoadBehavior |
REG_DWORD |
응용 프로그램에서 추가 기능을 로드할 시기와 추가 기능의 현재 상태(로드됨 또는 언로드됨)를 지정하는 값입니다. 기본적으로 이 항목은 시작 시 추가 기능이 로드되도록 지정하는 3으로 설정되어 있습니다. 자세한 내용은 LoadBehavior 값을 참조하십시오. |
Manifest |
REG_SZ |
추가 기능에 대한 응용 프로그램 매니페스트의 전체 경로입니다. 이 경로는 클라이언트 컴퓨터의 로컬 폴더여야 합니다. |
HKEY_CURRENT_USER\Software\Classes\add-in ID
항목 |
형식 |
값 |
|---|---|---|
(Default) |
REG_SZ |
추가 기능의 설명 |
HKEY_CURRENT_USER\Software\Classes\add-in ID\CLSID
항목 |
형식 |
값 |
|---|---|---|
(Default) |
REG_SZ |
추가 기능의 CLSID(Globally Unique Class Identifier) |
HKEY_CURRENT_USER\Software\Classes\CLSID\{<add-in CLSID>}
항목 |
형식 |
값 |
|---|---|---|
(Default) |
REG_SZ |
추가 기능의 설명 |
HKEY_CURRENT_USER\Software\Classes\CLSID\{<add-in CLSID>}\InprocServer32
항목 |
형식 |
값 |
|---|---|---|
(Default) |
REG_SZ - 또는 - REG_EXPAND_SZ |
추가 기능을 실행하는 컴퓨터에 있는 Visual Studio Tools for Office 로더의 전체 경로입니다. 이 항목은 항상 %CommonProgramFiles%\Microsoft Shared\VSTO\8.0\AddinLoader.dll로 설정되어야 합니다. Visual Studio Tools for Office 로더에 대한 자세한 내용은 Visual Studio Tools for Office 런타임 개요를 참조하십시오. 참고:
경로에 환경 변수를 사용하는 경우에는 이 항목에 REG_EXPAND_SZ 형식을 사용합니다. 그렇지 않으면 REG_SZ 형식을 사용합니다.
|
ManifestLocation |
REG_SZ |
추가 기능에 대한 응용 프로그램 매니페스트의 경로입니다. 이 경로는 클라이언트 컴퓨터의 로컬 폴더여야 합니다. |
ManifestName |
REG_SZ |
추가 기능의 응용 프로그램 매니페스트 이름 |
ThreadingModel |
REG_SZ |
스레딩 모델. 이 항목은 Both로 설정해야 합니다. |
HKEY_CURRENT_USER\Software\Classes\CLSID\{<add-in CLSID>}\ProgID
항목 |
형식 |
값 |
|---|---|---|
(Default) |
REG_SZ |
추가 기능의 고유 ID |
HKEY_CURRENT_USER\Software\Classes\CLSID\{<add-in CLSID>}\Programmable
항목 |
형식 |
값 |
|---|---|---|
(Default) |
REG_SZ |
이 항목의 값은 설정하지 마십시오. |
HKEY_CURRENT_USER\Software\Classes\CLSID\{<add-in CLSID>}\VersionIndependentProgID
항목 |
형식 |
값 |
|---|---|---|
(Default) |
REG_SZ |
추가 기능의 버전에 관계없는 고유 ID |
Windows Vista의 Microsoft Office 2003 추가 기능에 대한 레지스트리 항목
Windows Vista를 실행하는 컴퓨터에 Microsoft Office 2003 추가 기능을 배포하려면 다음과 같은 경우 일부 레지스트리 키를 다른 레지스트리 하위 트리에 만들어야 합니다.
사용자가 전체 관리자 액세스 토큰을 사용하여 Microsoft Office 2003 응용 프로그램을 실행하는 경우
- 또는 -
사용자가 UAC(사용자 계정 컨트롤)를 해제한 경우
이러한 경우 HKEY_LOCAL_MACHINE\Software\Classes 아래에 COM 등록 키(즉, HKEY_CURRENT_USER\Software\Classes 아래에 정의된 모든 키)를 만들어야 합니다.
이러한 경우 Windows Vista에서는 HKEY_LOCAL_MACHINE 아래에서만 COM 등록 키를 찾으므로 컴퓨터 하위 트리를 사용해야 합니다. 기본 설치 프로젝트의 레지스트리 키를 변경하는 방법에 대한 자세한 내용은 응용 프로그램 수준 추가 기능의 설치 프로젝트(2003 시스템)를 참조하십시오.
| 참고: |
|---|
이러한 경우 HKEY_CURRENT_USER\Software\Microsoft 아래에 있는 레지스트리 키는 이동하지 마십시오. |
LoadBehavior 값
HKEY_CURRENT_USER\Software\Microsoft\Office\application name\Addins\add-in ID 키 아래의 LoadBehavior 항목에는 응용 프로그램에서 추가 기능을 로드하는 시기와 추가 기능의 현재 상태(로드됨 또는 언로드됨)를 지정하는 값이 들어 있습니다. 기본적으로 추가 기능을 빌드하거나 배포할 때 이 항목은 3으로 설정됩니다.
다음 표에는 LoadBehavior 항목의 사용 가능한 값이 나와 있습니다.
값(10진) |
값 의미 |
설명 |
|---|---|---|
0 |
언로드됨 |
응용 프로그램이 시작될 때 추가 기능은 로드되지 않습니다. 응용 프로그램의 COM 추가 기능 대화 상자를 사용하여 추가 기능을 수동으로 로드할 수 있습니다. |
1 |
로드됨 |
응용 프로그램이 시작될 때 추가 기능은 로드되지 않습니다. 응용 프로그램의 COM 추가 기능 대화 상자를 사용하여 추가 기능을 수동으로 로드할 수 있습니다. |
2 |
시작 시 로드 | 언로드됨 |
응용 프로그램이 시작될 때 추가 기능이 로드됩니다. 응용 프로그램에서 추가 기능을 성공적으로 로드하면 LoadBehavior 값이 3으로 변경됩니다. |
3 |
시작 시 로드 | 로드됨 |
응용 프로그램이 시작될 때 추가 기능이 로드됩니다. 응용 프로그램에서 추가 기능을 성공적으로 로드하면 LoadBehavior 값이 3으로 유지됩니다. 추가 기능을 로드하는 동안 오류가 발생하면 LoadBehavior 값은 2로 변경됩니다. |
8 |
요청 시 로드 | 언로드됨 |
사용자가 추가 기능에 포함된 기능을 사용하는 UI(사용자 인터페이스) 요소를 클릭할 때와 같이 응용 프로그램에서 추가 기능이 필요할 경우에만 추가 기능이 로드됩니다. 응용 프로그램에서 추가 기능을 성공적으로 로드하면 LoadBehavior 값이 9로 변경됩니다. |
9 |
요청 시 로드 | 로드됨 |
사용자가 추가 기능에 포함된 기능을 사용하는 UI 요소를 클릭할 때와 같이 응용 프로그램에서 추가 기능이 필요할 경우에만 추가 기능이 로드됩니다. 응용 프로그램에서 추가 기능을 성공적으로 로드하면 LoadBehavior 값이 9로 유지됩니다. 추가 기능을 로드하는 동안 오류가 발생하면 LoadBehavior 값은 8로 변경됩니다. |
16 |
처음 시작 시 로드 |
사용자가 응용 프로그램을 처음으로 실행할 때 추가 기능이 로드됩니다. 다음에 응용 프로그램이 시작될 때는 추가 기능에 정의된 UI 요소는 모두 로드되지만 사용자가 추가 기능과 연결된 UI 요소를 클릭할 때까지 추가 기능은 로드되지 않습니다. 다음에 응용 프로그램이 시작될 때 응용 프로그램에서 추가 기능을 성공적으로 로드하면 LoadBehavior 값은 9로 변경됩니다. |