共用方式為

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 類別描述時做為描述。

flags

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

com-server-install-section

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

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

備註

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

在 COM 類別上呼叫 CoCreateInstance 之前，必須在每個進程中呼叫 CoRegisterDeviceCatalog。 呼叫 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 都必須提供 ServerType、 ServerBinary 和一或多個 AddComClass，每一行各有一個。

com-server-install-section 專案和值

ServerType

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

server-type-enum 伺服器類型 必要指示詞 選擇性指示詞
0x1 同處理序
  • 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"

另請參閱