com:SurrogateServer
하나 이상의 클래스 등록을 사용하여 SurrogateServer를 등록합니다.
요소 계층 구조
<com:SurrogateServer>
Syntax
<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>
키
{}
특정 발생 범위
특성 및 요소
특성
attribute | Description | 데이터 형식 | 필수 | 기본값 |
---|---|---|---|---|
CustomSurrogateExecutable | AppId 키의 DllSurrogate 경로입니다. 이 경로는 패키지 루트를 기준으로 하며 패키지의 파일을 참조해야 합니다. 이는 SystemSurrogate에서 변경적으로 배타적입니다. | 길이가 1~256자인 선택적 문자열로, 로 끝나 .exe 야 하며 , , > , : ? | " 또는 문자를 < 포함할 수 없습니다.* |
No | |
표시 이름 | DisplayName은 기본 AppID 키 값에 해당하는 지역화 가능한 문자열입니다. | 길이가 1~256자인 선택적 문자열입니다. | No | |
LaunchAndActivationPermission | AppID 키의 LaunchPermission 값에 해당하는 SDDL 문자열 입니다. | SDDL 문자열 값입니다. | No | |
AppId | 연결된 AppId 키를 참조하는 AppId입니다. | xxxxxxxx-xxxx-xxxx-xxxx-xx 형식의 선택적 GUID입니다. | No | |
SystemSurrogate | AppId 키의 DllSurrogate 값에서 잘 알려진 값에 해당하는 값입니다. 이는 CustomSurrogateExecutable에서 변경적으로 배타적입니다. | 선택적 문자열 값입니다. | 예 |
자식 요소
자식 요소 | 설명 |
---|---|
클래스 | SurrogateServer 클래스 등록을 정의합니다. |
부모 요소
자식 요소 | Description |
---|---|
com:ComServer | windows.comServer 형식의 패키지 확장 지점을 선언합니다. comServer 확장에는 ExeServer, SurrogateServer, ProgId 또는 TreatAsClass의 네 가지 등록 유형이 포함될 수 있습니다. |
설명
AppId 키에 DllSurrogate에 대한 값이 없는 경우 CustomSurrogateExecutable 특성을 사용하지 마세요.
LaunchAndActivationPermission은 AppID 키의 LaunchPermission 값에 해당하는 SDDL 문자열입니다.
SystemSurrogate는 AppId 키의 DllSurrogate 값 값에 해당합니다. 예를 들어 DllSurrogate 값이 %System32%\prevhost.exe
또는 %SysWow64%\prevhost.exe
이면 SystemSurrogate 를 로 PreviewHost
설정하고 CustomSurrogateExecutable 을 설정하면 안 됩니다.
요구 사항
항목 | 값 |
---|---|
Namespace | http://schemas.microsoft.com/appx/manifest/com/windows10 |
Minimum OS Version | Windows 10 버전 1703(빌드 15063) |