共用方式為


INF AddComServer 指示詞

AddComServer 指示詞會在 DDInstall.COM 區段中使用,並註冊 COM 伺服器。 必須在 DDInstall.COM 區段中定義一或多個 COM 伺服器。 Windows 11 版本 24H2 和更新版本支援本節。

[DDInstall.COM]

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

條目

com-server-name

指定要安裝的 COM 伺服器名稱。 名稱通常是註冊之 COM 元件的名稱或描述。 COM 伺服器名稱在 INF 內必須是唯一的,而且會在缺少 COM 類別描述時做為描述。

旗幟

指定 AddComServer 指示詞的額外旗標。 旗標欄位保留供日後使用,應保留空白或設定為零。

com-server-install-section

參考 INF 寫入器定義的區段,其中包含註冊 COM 伺服器及其類別的資訊。

如需 COM 伺服器安裝一節的詳細資訊,請參閱下列和<一般 COM 伺服器>,請參閱 COM 用戶端和伺服器

備註

AddComServer 指示詞會導致系統設定在驅動程式套件的 驅動程式存放區相對路徑註冊伺服器二進位檔所實作的 COM 伺服器。

CoRegisterDeviceCatalog 必須在每個程式中呼叫,才能在 COM 類別上呼叫 CoCreateInstance。 呼叫 CoRegisterDeviceCatalog 可讓 COM 運行時間在程式中使用 COM 伺服器註冊。

INF DDInstall.COM 區段中每個 AddComServer 指示詞都可以參考 INF 檔案中其他地方的 INF 寫入器定義 com-server-install-section。 每個 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-section 都必須提供 ServerTypeServerBinary 和一或多個 AddComClass,每行各有一行。

com-server-install-section 專案和值

ServerType

指定要註冊的 COM 伺服器類型。 每個 COM 伺服器類型都有一組特定的必要和選擇性專案和指示詞。 僅支援0x1(內部程式)。

server-type-enum 伺服器類型 必要指示詞 選擇性指示詞
0x1 In-proc
  • ServerBinary
  • AddComClass
  • ServerBinaryWow64
  • ThreadingModel

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"

另請參閱