com:Class(SurrogateServer/Class)

아티클
10/30/2023

SurrogateServer 클래스 등록을 정의합니다.

요소 계층 구조

<com:SurrogateServer>

<com:Class>

Syntax

<com:Class
    Id = 'A GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    Path = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ThreadingModel = 'A string that can be one of the following values: "Both", "STA", "MTA", "MainSTA", "Neutral".'
    DisplayName = 'An optional string with a value between 1 and 256 characters in length. This string is localizable.'
    EnableOleDefaultHandler = 'An optional boolean value.'
    ProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    VersionIndependentProgId = 'An optional alphanumeric string separated by a period with a value between 1 and 255 characters in length (for example, Foo.Bar or Foo.Bar.1)'
    AutoConvertTo = 'An optional GUID in the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.'
    InsertableObject = 'An optional boolean value.'
    ShortDisplayName = 'An optional string with a value between 1 and 40 characters in length.' >

  <!-- Child elements -->
  ( ImplementedCategories,
  Conversion?,
  DataFormats?,
  MiscStatus?,
  Verbs?,
  DefaultIcon?,
  ToolboxBitmap32? 
  )

</com:Class>

키

? 선택 사항(0개 또는 1개)

특성 및 요소

특성

attribute	Description	데이터 형식	필수
ID	ID 특성은 CLSID에 해당합니다.	xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxx 형식의 GUID입니다.	Yes
Path	서로게이트 클래스 DLL의 전체 경로입니다.	, `?>*:\|"`또는 문자를 포함할 수 없는 길이가 1~256자`<`인 문자열입니다.	Yes
ThreadingModel	DLL을 로드하기 위한 스레딩 모델입니다.	다음 값 중 하나일 수 있는 문자열입니다. 둘 다, STA, MTA, MainSTA, Neutral입니다.	Yes
표시 이름	CLSID 키의 기본값에 해당하는 지역화 가능한 문자열입니다.	길이가 1~256자인 선택적 문자열입니다.	No
EnableOleDefaultHandler	InprocHandler32 키의 기본값이 "Ole32.dll"인 경우 true로 설정해야 합니다. 그렇지 않으면 생략해야 합니다. 기본값은 false입니다.	선택적 부울 값입니다.	No
ProgId	ProgID(프로그래밍 식별자)를 CLSID와 연결합니다.	길이가 1~255자인 마침표로 구분된 선택적 영숫자 문자열입니다(예: Foo.Bar 또는 Foo.Bar.1).	No
VersionIndependentProgId	ProgID를 CLSID와 연결합니다. 이 값은 개체 애플리케이션의 최신 버전을 결정하는 데 사용됩니다.	길이가 1~255자인 마침표로 구분된 선택적 영숫자 문자열입니다(예: Foo.Bar 또는 Foo.Bar.1).	No
AutoConvertTo	지정된 개체 클래스를 새 개체 클래스로 자동 변환하도록 지정합니다.	xxxxxxxx-xxxx-xxxx-xx 형식의 선택적 GUID입니다.	No
InsertableObject	이 클래스를 삽입할 수 있음을 나타냅니다.	선택적 부울 값입니다.	No
ShortDisplayName	클래스 표시 이름의 짧은 버전입니다.	길이가 1~40자인 선택적 문자열입니다.	No

자식 요소

자식 요소	Description
ImplementedCategories	클래스에서 구현하는 범주를 지정합니다.
변환	클래스의 읽기/쓰기 권한을 지정합니다.
DataFormats	지원되는 기본 및 기본 데이터 형식을 지정합니다.
MiscStatus	개체를 만들고 표시하는 방법을 지정합니다.
동사	애플리케이션에 등록할 동사를 지정합니다.
DefaultIcon	개체의 상징적인 프레젠테이션에 대한 기본 아이콘 정보를 제공합니다.
ToolboxBitmap32	도구 모음 또는 도구 상자 단추의 얼굴에 사용할 16 x 16 비트맵의 모듈 이름 및 리소스 ID를 식별합니다.

부모 요소

부모 요소	Description
com:SurrogateServer	하나 이상의 클래스 등록을 사용하여 SurrogateServer를 등록합니다.

설명

동일한 AppId를 사용하는 클래스 등록은 서로 다른 애플리케이션/애플리케이션 매니페스트 요소에 등록해야 하는 경우가 아니면 SurrogateServer를 공유해야 합니다.

ThreadingModel은 InprocServer32 스레딩 모델에 해당합니다. SurrogateServer 클래스 등록에는 패키지의 프라이빗 하이브에 InprocServer32 등록이 있어야 합니다.

요구 사항

항목	값
Namespace	`http://schemas.microsoft.com/appx/manifest/com/windows10`
Minimum OS Version	Windows 10 버전 1703(빌드 15063)