com:SurrogateServer

  • [アーティクル]

SurrogateServer を 1 つまたは複数のクラス登録に登録します。

要素の階層

<パッケージ>

    <アプリケーション>

         <Application>

              <拡張機能>

                   <com:Extension>

                        <com:ComServer>

                             <com:SurrogateServer>

構文

<com:SurrogateServer  
    CustomSurrogateExecutable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    LaunchAndActivationPermission = 'A [SDDL string](/windows/win32/secauthz/security-descriptor-string-format) value.'
    AppId = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.' 
    SystemSurrogate = 'An optional string value.' >

  <!-- Child elements -->
  Class{1,10000}

</com:SurrogateServer>

キー

{} 特定の出現範囲

属性と要素

属性

属性 説明 データ型 必須 既定値
CustomSurrogateExecutable AppId キーの DllSurrogate へのパス。 このパスはパッケージ ルートに対する相対パスであり、パッケージ内のファイルを参照する必要があります。 これは、SystemSurrogate では変更できません。 1 から 256 文字の長さの値を持つ省略可能な文字列。末尾.exeは 、、または の"?<>:|文字を含めることはできません。* いいえ
DisplayName DisplayName は、既定の AppID キー値に対応するローカライズ可能な文字列です。 1 ~ 256 文字の長さの値を持つ省略可能な文字列。 いいえ
LaunchAndActivationPermission AppID キーの LaunchPermission 値に対応する SDDL 文字列 。 SDDL 文字列値。 いいえ
AppId 関連付けられた AppId キーを参照する AppId。 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 形式の省略可能な GUID。 いいえ
SystemSurrogate AppId キーの DllSurrogate 値の既知の値に対応する 値。 これは、CustomSurrogateExecutable では変更できません。 省略可能な文字列値。 いいえ

子要素

子要素 説明
クラス SurrogateServer クラスの登録を定義します。

親要素

子要素 説明
com:ComServer windows.comServer 型のパッケージ拡張ポイントを宣言します。 comServer 拡張機能には、ExeServer、SurrogateServer、ProgId、または TreatAsClass の 4 種類の登録が含まれる場合があります。

注釈

AppId キーに DllSurrogate の値がない場合は、CustomSurrogateExecutable 属性を使用しないでください。

LaunchAndActivationPermission は、AppID キーの LaunchPermission 値に対応する SDDL 文字列です。

SystemSurrogate は、AppId キーの DllSurrogate 値の値に対応します。 たとえば、DllSurrogate の値が または %SysWow64%\prevhost.exeの場合、%System32%\prevhost.exeSystemSurrogate を にPreviewHost設定し、CustomSurrogateExecutable を設定しないでください。

必要条件

Item 値
Namespace http://schemas.microsoft.com/appx/manifest/com/windows10
Minimum OS Version Windows 10 バージョン 1703 (ビルド 15063)