com4:InProcessServerClassReference

아티클
10/23/2024

등록된 in-process 서버가 연결된 클래스 또는 클래스 참조를 지정하고 등록 세부 정보를 설정합니다.

요소 계층 구조

<패키지>

<애플리케이션>

<확장>

<com4:SurrogateServer>

<com4:InProcessServerClassReference>

<확장>

<com4:SurrogateServer>

<com4:InProcessServerClassReference>

통사론

<com4:InProcessServerClassReference
  EnableOleDefaultHandler = 'A boolean value.'
  Id = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' />

특성 및 요소

특성

속성	묘사	데이터 형식	필수	기본값
EnableOleDefaultHandler	InprocHandler32 키의 기본값이 `Ole32.dll`경우 true로 설정해야 합니다. 그렇지 않으면 생략해야 합니다.	부울 값입니다.	예	False
ID	참조되는 클래스 ID입니다.	xxxxxxxx-xxxx-xxxx-xxxx-xxxx 형식의 GUID입니다.	예

자식 요소

없음.

부모 요소

Parent 요소	묘사
com4:SurrogateServer	하나 이상의 클래스 등록을 사용하여 SurrogateServer를 등록합니다.

발언

COM 레지스트리 레이아웃의 CLSID 키](/windows/win32/com/clsid-key-hklm)를 사용하면 다음을 지정하여 CLSID를 inproc activation(CLSCTX_INPROC_SERVER) 및 서로게이트 서버(CLSCTX_LOCAL_SERVER)에서 outofproc 활성화에 등록할 수 있습니다.

InprocServer32 하위 키의 Inproc 활성화 세부 정보입니다.
CLSID 키의 AppID 값을 통해 AppID 키에 대한 참조입니다. 여기서 AppID 키는 DllSurrogate 값을 통해 서로게이트를 지정합니다. 서로게이트 서버에서 outofproc 활성화의 경우 inproc 서버 등록 세부 정보, e.g. dll 경로 및 ThreadingModeloutofproc 활성화에도 사용됩니다. ClassReference InProcessServer 요소의 자식은 inproc 및 outofproc 활성화 모두에 대해 CLSID를 등록하는 패키지를 사용하여 프로시저 서버 세부 정보를 한 번 지정하도록 합니다. inProcessServer/Class 또는 InProcessServer/ClassReference 요소로 CLSID의 outofproc 활성화를 지원하는 SurrogateServer에서 이 요소를 참조합니다. inproc/outofproc 등록에 대한 이 구조는 InProcessServer/ClassReference 및 SurrogateServer/ClassReference 요소 모두에서 dll 경로 및 ThreadingModel을 독립적으로 지정하는 것보다 COM 레지스트리 레이아웃을 더 밀접하게 반영합니다.

서로게이트 서버에서 outofproc 활성화를 위해 등록된 CLSID를 사용하여 애플리케이션을 패키징하는 경우 일반적으로 서로게이트 서버만 매니페스트에 등록하는 것이 좋습니다. 예를 들어 서로게이트 등록은 이전에 프로시브 서버 구현을 사용하도록 설정했지만 이제는 격리를 위한 모범 사례로 outofproc 서버 등록을 권장하는 COM 기반 확장 지점을 지원하는 데 자주 사용됩니다. 패키지된 애플리케이션의 경우 inproc 서버(자세한 내용은 in-ProcessServers 참조)에 대한 추가 기능 제한이 있는 반면, runFullTrust 제한 기능이 있는 패키지는 서로게이트 서버를 성공적으로 등록할 수 있으며, 대부분의 확장 지점에서 서로게이트 서버를 등록하는 경우 확장 기능을 사용하도록 설정하기에 충분합니다. 그러나 패키지된 애플리케이션이 CLSCTX_INPROC_SERVER(inproc Activation)을 요청하는 다른 애플리케이션과의 호환성을 위해 CLSID의 비확산 활성화를 지원해야 하고, 프로시브 서버 등록 요구 사항을 충족하는 경우 대리에서 프로시브 활성화 및 outofproc 활성화를 위해 CLSID를 등록할 수 있습니다. 이 경우 inprocessServer/Class 또는 InProcessServer/ClassReference 요소에 inproc 서버 세부 정보를 제공하고 SurrogateServer/InProcessServerClassReference 요소에서 참조하는 것이 좋습니다.

예제

다음 예제에서는 InProcessServerClassreference 사용하여 서로게이트 서버 등록의 클래스를 참조하는 방법을 보여 줍니다.

<com4:Class Id="d57899b9-1334-4600-904a-719df0512988" DisplayName="CLSID_Baz"/> 
<com4:InProcessServer Path="MyServer.dll"> 
  <com4:ClassReference Id="d57899b9-1334-4600-904a-719df0512988" ThreadingModel="Apartment"/> 
</com4:InProcessServer> 
<com:SurrogateServer DisplayName="My surrogate server"> 
  <com4:InProcessServerClassReference Id="d57899b9-1334-4600-904a-719df0512988"/> 
</com:SurrogateServer>

요구 사항

항목	값
네임스페이스	`http://schemas.microsoft.com/appx/manifest/com/windows10/4`
최소 OS 버전	Windows 10(빌드 20348)

다음을 통해 공유