Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Une directive AddComServer est utilisée dans une section DDInstall.COM et inscrit un serveur COM. Un ou plusieurs serveurs COM doivent être définis dans une section DDInstall.COM. Cette section est prise en charge pour Windows 11 version 24H2 et ultérieure.
[DDInstall.COM]
AddComServer = com-server-name, [flags], com-server-install-section
entrepôt
com-server-name
Spécifie le nom du serveur COM en cours d’installation. Le nom est généralement le nom ou la description du composant COM en cours d’inscription. Le nom du serveur COM doit être unique dans l’INF et est utilisé comme description lorsque la description de la classe COM est manquante.
Drapeaux
Spécifie des indicateurs supplémentaires pour la directive AddComServer. Le champ indicateurs est réservé pour une utilisation ultérieure et doit être laissé vide ou défini sur zéro.
com-server-install-section
Fait référence à une section définie par l’enregistreur INF qui contient des informations pour l’inscription du serveur COM et de ses classes.
Pour plus d’informations sur la section d’installation du serveur COM, consultez les remarques suivantes et pour les serveurs COM en général, consultez clients et serveurs COM.
Remarques
La directive AddComServer entraîne l’inscription d’un serveur COM implémenté par un fichier binaire de serveur dans le chemin d’accès relatif du magasin de pilotes du package de pilotes.
CoRegisterDeviceCatalog doit être appelée dans chaque processus avant d’appeler CoCreateInstance sur la classe COM. L’appel CoRegisterDeviceCatalog rend les inscriptions de serveur COM disponibles dans le processus d’utilisation du runtime COM.
Chaque directive addComServer dans une section INF DDInstall.COM peut référencer une section com-server-install-install-defined inf-writer ailleurs dans le fichier INF. Chaque nom de section défini par l’enregistreur INF doit être unique dans le fichier INF et doit suivre les règles générales de définition des noms de section. Pour plus d'informations sur ces règles, voir Règles générales de syntaxe pour les fichiers INF.
Une directive AddComServer doit référencer une section nommée com-server-install-section ailleurs dans l’INF. Chaque section de ce type a la forme suivante :
[com-server-install-section]
ServerType = server-type
ServerBinary = binary-path
[ServerBinaryWow64 = wow64-binary-path]
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Chaque section com-server-install-section doit fournir ServerType, ServerBinary et un ou plusieurs AddComClass, chacun sur une ligne distincte.
entrées et valeurs com-server-install-section
ServerType
Spécifie le type de serveur COM inscrit. Chaque type de serveur COM a un ensemble spécifique d’entrées et directives obligatoires et facultatives. seul 0x1 (in-proc) est pris en charge.
| server-type-enum | Type de serveur | Directives requises | Directives facultatives |
|---|---|---|---|
| 0x1 | Dans processus |
|
|
serverBinary
Chemin d’accès au fichier binaire du serveur COM pour l’architecture native.
ServerBinaryWow64
Chemin d’accès au binaire WOW64 du serveur COM pour la prise en charge de l’architecture x86 non native sur la plateforme AMD64.
AddComClass = {clsid-guid}[, flags[, com-class-install-section]]
Cette directive requise peut être utilisée une ou plusieurs fois pour inscrire des classes COM avec des sections d’installation facultatives.
Pour plus d’informations sur l’inscription de classes COM, consultez directive AddComClass INF.
Exemple :
[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"