Dyrektywa INF AddComServer

Dyrektywa AddComServer jest używana w sekcji DDInstall.COM i rejestruje serwer COM. Co najmniej jeden serwer COM musi być zdefiniowany w sekcji DDInstall.COM. Ta sekcja jest obsługiwana w systemie Windows 11 w wersji 24H2 lub nowszej.

[DDInstall.COM]

AddComServer = com-server-name, [flags], com-server-install-section

Wpisy

com-server-name

Określa nazwę instalowanego serwera COM. Nazwa jest zazwyczaj nazwą lub opisem zarejestrowanego składnika COM. Nazwa serwera COM musi być unikatowa w obrębie INF i jest używana jako opis, gdy brakuje opisu klasy COM.

Flagi

Określa dodatkowe flagi dla dyrektywy AddComServer. Pole flag jest zarezerwowane do użytku w przyszłości i powinno być pozostawione puste lub ustawione na zero.

com-server-install-section

Odwołuje się do sekcji zdefiniowanej przez moduł zapisywania INF, która zawiera informacje dotyczące rejestrowania serwera COM i jego klas.

Aby uzyskać więcej informacji na temat sekcji instalowania serwera COM, zobacz następujące uwagi, a w przypadku serwerów COM ogólnie, zobacz klientów COM i serwerów.

Uwagi

Dyrektywa AddComServer powoduje, że instalator systemu rejestruje serwer COM zaimplementowany przez plik binarny serwera w ścieżce względnej magazynu sterowników pakietu sterowników.

CoRegisterDeviceCatalog należy wywołać w każdym procesie przed wywołaniem CoCreateInstance w klasie COM. Wywoływanie CoRegisterDeviceCatalog sprawia, że rejestracje serwera COM są dostępne w procesie, aby środowisko uruchomieniowe COM było używane.

Każda dyrektywa AddComServer w sekcji DDInstall.COM INF może odwoływać się do sekcji com-server-install-defined com-server-install-w pliku INF. Każda nazwa sekcji zdefiniowanej przez moduł zapisywania INF musi być unikatowa w pliku INF i musi być zgodna z ogólnymi regułami definiowania nazw sekcji. Aby uzyskać więcej informacji na temat tych reguł, zobacz ogólne reguły składni dla plików INF.

Dyrektywa AddComServer musi odwoływać się do nazwy com-server-install-section w innym miejscu w innej części INF. Każda taka sekcja ma następującą formę:

[com-server-install-section]

ServerType            = server-type
ServerBinary          = binary-path
[ServerBinaryWow64    = wow64-binary-path]
AddComClass           = {clsid-guid}[, flags[, com-class-install-section]]

Każdy com-server-install-section musi podać ServerType, ServerBinary i co najmniej jeden AddComClass, każdy w osobnym wierszu.

com-server-install-section wpisy i wartości

ServerType

Określa typ serwera COM, który jest rejestrowany. Każdy typ serwera COM ma określony zestaw wymaganych i opcjonalnych wpisów i dyrektyw. obsługiwana jest tylko 0x1 (w proc).

ServerBinary

Ścieżka do pliku binarnego serwera COM dla architektury natywnej.

ServerBinaryWow64

Ścieżka do pliku binarnego serwera COM WOW64 dla architektury x86 nienatywnej na platformie AMD64.

AddComClass = {clsid-guid}[, flags[, com-class-install-section]]

Ta wymagana dyrektywa może służyć co najmniej raz do rejestrowania klas COM w opcjonalnych sekcjach instalacji.

Aby uzyskać więcej informacji na temat rejestrowania klas COM, zobacz INF AddComClass, dyrektywa.

Przykład

[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"

Zobacz też

• przy użyciu pliku INF składnika
• sekcji DDInstall.COM INF
• dyrektywy INF AddComClass
• dyrektywy AddInterface INF