Directiva AddComServer inf
Una directiva AddComServer se usa en una sección de DDInstall.COM y registra un servidor COM. Uno o varios servidores COM deben definirse en una sección de DDInstall.COM. Esta sección es compatible con Windows 11 versión 24H2 y versiones posteriores.
[DDInstall.COM]
AddComServer = com-server-name, [flags], com-server-install-section
Movimientos
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.
Banderas
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, vea los comentarios siguientes y para los servidores COM en general, vea clientes y servidores COM.
Observaciones
La directiva AddComServer hace que la configuración del sistema registre un servidor COM implementado por un binario de servidor en la ruta de acceso relativa del almacén de controladores de un paquete de controladores.
coRegisterDeviceCatalog debe llamarse en cada proceso antes de llamar a CoCreateInstance en la clase COM. Llamar a CoRegisterDeviceCatalog hace que los registros del servidor COM estén disponibles en el proceso para que el entorno de ejecución com lo use.
Cada directiva AddComServer de una sección de DDInstall.COM INF puede hacer referencia a una sección com-server-install-fined de INF en otro lugar del archivo INF. Cada nombre de sección definido por INF-writer 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 la siguiente forma:
[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 una o varias AddComClass, cada una en una línea independiente.
entradas y valores de com-server-install-section
ServerType de
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 de acceso al binario del servidor COM para la arquitectura nativa.
ServerBinaryWow64
Ruta de acceso 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"