OutOfProcessServer(Windows 10)

아티클
10/30/2023

windows.activatableClass.outOfProcessServer 형식의 패키지 확장 지점을 선언합니다. 앱은 하나 이상의 활성화 가능한 클래스를 노출하는 실행 파일(.exe)을 사용합니다.

요소 계층 구조

<OutOfProcessServer>

Syntax

<OutOfProcessServer
  ServerName = 'An alphanumeric string (dots are allowed) with a value between 1 and 255 characters in length. Must begin with a letter.' 
  RunFullTrust = 'An optional boolean value.'
  IdentityType = 'An optional string that can be one of the following values: "activateAsPackage" or "activateAsActivator".' >

  <!-- Child elements -->
  Path
  Arguments?
  Instancing
  ActivatableClass{1,65535}

</OutOfProcessServer>

키

? 선택적(0개 또는 1개) {} 특정 발생 범위

특성 및 요소

특성

attribute	Description	데이터 형식	필수
데이터 열이 추적에서 캡처되고 서버를 사용할 수 있으면	패키지 내에서 고유한 구문상 유효한 문자열입니다. 규칙에 따라 실행 파일의 이름입니다.	길이가 1~255자인 영숫자 문자열(점 허용)입니다. 문자로 시작해야 합니다.	Yes
RunFullTrust	true이면 UWP 토큰이 아닌 Windows 데스크톱 브리지 토큰으로 서버가 시작됩니다.	선택적 부울 값입니다.	No
IdentityType	서버의 활성화 유형입니다.	activateAsPackage 또는 activateAsActivator 값 중 하나일 수 있는 선택적 문자열입니다.	No

자식 요소

자식 요소	Description
ActivatableClass(형식: CT_OutOfProcessActivatableClass)	확장성 지점과 연결된 런타임 클래스를 선언합니다.
인수	실행 파일에 전달할 쉼표로 구분된 인수 목록을 지정합니다.
인스턴싱	실행 파일이 단일 instance 실행되는지 또는 여러 인스턴스로 실행할 수 있는지 여부를 지정합니다.
경로(형식: ST_Executable)	확장에 대한 기본 실행 파일입니다.

부모 요소

부모 요소	Description
확장(형식: CT_PackageExtensions)	패키지의 확장 지점을 선언합니다.

설명

이 IdentityType 로 activateAsPackage설정된 경우 서버는 활성화 프로세스의 토큰에 따라 달라지지 않는 토큰으로 시작됩니다.

예제

<Extension
  Category="windows.activatableClass.outOfProcessServer">
  <OutOfProcessServer
    ServerName="Microsoft.SDKSamples.ToastServer">
    <Path>Microsoft.Samples.ExeServerAuthoring.exe</Path>
    <Instancing>singleInstance</Instancing>
    <ActivatableClass
      ActivatableClassId="Microsoft.Samples.ExeServerAuthoring.Toaster" />
  </OutOfProcessServer>
</Extension>

요구 사항

항목	값
Namespace	`http://schemas.microsoft.com/appx/manifest/foundation/windows10`