Directiva AddComServer de INF
Una directiva AddComServer se usa en una sección DDInstall.COM y registra un servidor COM. Uno o varios servidores COM deben definirse en una sección DDInstall.COM. Esta sección se admite para Windows 11 versión 24H2 y posteriores.
[DDInstall.COM]
AddComServer = com-server-name, [flags], com-server-install-section
Entries
com-server-name
Especifica el nombre del servidor COM que se va a instalar. El nombre suele ser el nombre o la descripción del componente COM que se está registrando. El nombre del servidor COM debe ser único dentro del INF y se usa como descripción cuando falta la descripción de la clase COM.
flags
Especifica marcas adicionales para la directiva AddComServer. El campo flags está reservado para uso futuro y debe dejarse en blanco o establecerse en cero.
com-server-install-section
Hace referencia a una sección definida por INF-writer que contiene información para registrar el servidor COM y sus clases.
Para obtener más información sobre la sección instalación del servidor COM, consulte los comentarios siguientes y para los servidores COM en general, consulte Clientes y servidores COM.
Comentarios
La directiva AddComServer hace que la configuración del sistema registre un servidor COM implementado por un binario de servidor en la ruta relativa del almacén de controladores de un paquete de controladores.
Se debe llamar a CoRegisterDeviceCatalog en cada proceso antes de llamar a CoCreateInstance en la clase COM. Al llamar a CoRegisterDeviceCatalog , los registros del servidor COM están disponibles en el proceso para que el entorno de ejecución COM los use.
Cada directiva AddComServer de una sección DDInstall.COM de INF puede hacer referencia a una sección INF-writer-defined com-server-install-section en otra parte del archivo INF. Cada nombre de sección INF-writer-defined debe ser único dentro del archivo INF y debe seguir las reglas generales para definir nombres de sección. Para obtener más información sobre estas reglas, consulte Reglas generales de sintaxis para archivos INF.
Una directiva AddComServer debe hacer referencia a una sección denominada com-server-install-section en otra parte del INF. Cada sección de este tipo tiene el siguiente formato:
[com-server-install-section]
ServerType = server-type
ServerBinary = binary-path
[ServerBinaryWow64 = wow64-binary-path]
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Cada com-server-install-section debe proporcionar ServerType, ServerBinary y uno o varios AddComClass, cada uno en una línea independiente.
Entradas y valores de com-server-install-section
ServerType
Especifica el tipo de servidor COM que se está registrando. Cada tipo de servidor COM tiene un conjunto específico de entradas y directivas obligatorias y opcionales. Solo se admite 0x1 (en proceso).
| server-type-enum | Tipo de servidor | Directivas requeridas | Directivas opcionales |
|---|---|---|---|
| 0x1 | En proceso |
|
|
ServerBinary
Ruta al binario del servidor COM para la arquitectura nativa.
ServerBinaryWow64
Ruta al archivo binario WOW64 del servidor COM para la compatibilidad con la arquitectura x86 no nativa en la plataforma AMD64.
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Esta directiva necesaria se puede usar una o varias veces para registrar clases COM con secciones de instalación opcionales.
Para obtener más información sobre cómo registrar clases COM, consulte Directiva AddComClass de INF.
Ejemplo
[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"