INF AddComServer 지시문
AddComServer 지시문은 DDInstall.COM 섹션 내에서 사용되며 COM 서버를 등록합니다. 하나 이상의 COM 서버를 DDInstall.COM 섹션에서 정의해야 합니다. 이 섹션은 Windows 11 버전 24H2 이상에서 지원됩니다.
[DDInstall.COM]
AddComServer = com-server-name, [flags], com-server-install-section
엔트리
com-server-name
설치할 COM 서버의 이름을 지정합니다. 이름은 일반적으로 등록 중인 COM 구성 요소의 이름 또는 설명입니다. COM 서버 이름은 INF 내에서 고유해야 하며 COM 클래스 설명이 누락된 경우 설명으로 사용됩니다.
flags
AddComServer 지시문에 대한 추가 플래그를 지정합니다. 플래그 필드는 나중에 사용할 수 있도록 예약되어 있으며 비워 두거나 0으로 설정해야 합니다.
com-server-install-section
COM 서버 및 해당 클래스를 등록하기 위한 정보가 포함된 INF 작성기 정의 섹션을 참조합니다.
COM 서버 설치 섹션에 대한 자세한 내용은 다음 주의 사항을 참조하고, 일반적으로 COM 서버는 COM 클라이언트 및 서버를 참조 하세요.
설명
AddComServer 지시문을 사용하면 시스템 설정에서 드라이버 패키지의 드라이버 저장소 상대 경로에 서버 이진 파일로 구현된 COM 서버를 등록합니다.
COM 클래스에서 CoCreateInstance를 호출하기 전에 모든 프로세스에서 CoRegisterDeviceCatalog를 호출해야 합니다. CoRegisterDeviceCatalog를 호출하면 COM 런타임에서 사용할 프로세스에서 COM 서버 등록을 사용할 수 있습니다.
INF DDInstall.COM 섹션의 각 AddComServer 지시문은 INF 파일의 다른 위치에서 INF-writer 정의 com-server-install-섹션을 참조할 수 있습니다. 각 INF 작성기 정의 섹션 이름은 INF 파일 내에서 고유해야 하며 섹션 이름을 정의하기 위한 일반 규칙을 따라야 합니다. 이러한 규칙에 대한 자세한 내용은 INF 파일에 대한 일반 구문 규칙을 참조 하세요.
AddComServer 지시문은 INF의 다른 위치에서 명명된 com-server-install-section을 참조해야 합니다. 이러한 각 섹션의 형식은 다음과 같습니다.
[com-server-install-section]
ServerType = server-type
ServerBinary = binary-path
[ServerBinaryWow64 = wow64-binary-path]
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
각 com-server-install-섹션은 각각 별도의 줄에 ServerType, ServerBinary 및 하나 이상의 AddComClass를 제공해야 합니다.
com-server-install-section 항목 및 값
Servertype
등록 중인 COM 서버의 유형을 지정합니다. 각 COM 서버 유형에는 특정 필수 항목 및 선택적 항목 및 지시문 집합이 있습니다. 0x1(In-proc)만 지원됩니다.
server-type-enum | 서버 유형 | 필수 지시문 | 선택적 지시문 |
---|---|---|---|
0x1 | In-proc |
|
|
ServerBinary
네이티브 아키텍처에 대한 COM 서버 이진 파일의 경로입니다.
ServerBinaryWow64
AMD64 플랫폼에서 네이티브가 아닌 x86 아키텍처 지원을 위한 COM 서버 WOW64 이진 파일 경로입니다.
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
이 필수 지시문은 선택적 설치 섹션에 COM 클래스를 등록하는 데 하나 이상 사용할 수 있습니다.
COM 클래스를 등록하는 방법에 대한 자세한 내용은 INF AddComClass 지시문을 참조하세요.
예시
[ContosoEncoderServer.NT.COM]
AddComServer = ContosoEncoderServer,, ContosoEncoder_ComServer_Inst
[ContosoEncoder_ComServer_Inst]
ServerType = 1 ; in-proc
ServerBinary = %13%\contoso_encoder.dll
AddComClass = {bb2b85ab-9473-42e5-8d1a-0f01d3879879}
AddComClass = {f1baf99b-d28a-4ea3-b652-355da082d260}, 0, ContosoEncoderControl_ComClass_Inst
[ContosoEncoderControl_ComClass_Inst]
Description = %ContosoEncoder_Comclass_Desc%
ThreadingModel = Apartment
[Strings]
%ContosoEncoder_Comclass_Desc%="Contoso H.264 Encoder"