다음을 통해 공유


com:SurrogateServer

하나 이상의 클래스 등록을 사용하여 SurrogateServer를 등록합니다.

요소 계층 구조

<패키지>

    <애플리케이션>

         <애플리케이션>

              <확장>

                   <com:Extension>

                        <com:ComServer>

                             <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 특성을 사용하지 마세요.

LaunchAndActivationPermissionAppID 키의 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)