OutOfProcessServer (Windows 10)

  • [アーティクル]

windows.activatableClass.outOfProcessServer 型のパッケージ拡張ポイントを宣言します。 アプリは、1 つ以上のアクティブ化可能なクラスを公開する実行可能ファイル (.exe) を使用します。

要素の階層

<パッケージ>

    <拡張機能>

         <拡張子>

              <OutOfProcessServer>

構文

<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) {} の特定の出現範囲

属性と要素

属性

属性 説明 データ型 必須 既定値
ServerName パッケージ内で一意の構文上有効な文字列。 慣例により、これは実行可能ファイルの名前です。 長さが 1 ~ 255 文字の英数字文字列 (ドットを使用できます)。 文字で始まる必要があります。 Yes
RunFullTrust true の場合、UWP トークンではなく、Windows デスクトップ ブリッジ トークンを使用してサーバーが起動されます。 省略可能なブール値。 いいえ
IdentityType サーバーのアクティブ化の種類。 次のいずれかの値を指定できる省略可能な文字列: activateAsPackage または activateAsActivator。 いいえ

子要素

子要素 説明
ActivatableClass (型: CT_OutOfProcessActivatableClass) 拡張ポイントに関連付けられているランタイム クラスを宣言します。
引数 実行可能ファイルに渡すコンマ区切りの引数の一覧を指定します。
インスタンス化 実行可能ファイルを 1 つのインスタンスとして実行するか、複数のインスタンスとして実行できるかを指定します。
パス (型: ST_Executable) この拡張機能の既定の実行可能ファイル。

親要素

親要素 説明
拡張機能 (種類: 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>

必要条件

Item 値
Namespace http://schemas.microsoft.com/appx/manifest/foundation/windows10