SurrogateServer を 1 つまたは複数のクラス登録に登録します。
要素の階層
<Package>
└─ <Applications>
└─ <Application>
└─ <Extensions>
└─ <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 では複数の排他的です。 |
.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 値が %System32%\prevhost.exe または %SysWow64%\prevhost.exeの場合、 SystemSurrogate を PreviewHost に設定し、 CustomSurrogateExecutable を 設定しないでください。
Requirements
| 品目 | 価値 |
|---|---|
| 名前空間 | http://schemas.microsoft.com/appx/manifest/com/windows10 |
| 最小 OS バージョン | Windows 10 バージョン 1703 (ビルド 15063) |