Como: usar a ferramenta de configuração do modelo de serviço COM+

Artigo
05/10/2023

Depois que você tiver selecionado um modo de hospedagem apropriado, use a ferramenta de linha de comando Configuração de Modelo de Serviço COM+ (ComSvcConfig.exe) para configurar as interfaces de aplicativo que serão expostas como serviços Web.

Observação

Você deve ser administrador no computador para executar as tarefas a seguir.

Ao usar ComSvcConfig.exe em um computador com Windows 7 para configurar um serviço Web para usar a versão mais recente do modelo de serviço (atualmente v4.5), execute as seguintes etapas:

Defina a chave do Registro [HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLR para um valor DWORD de 0x00000001
Executar comsvcconfig.exe
Reverter a chave do Registro adicionada na etapa 1 de volta para o seu valor original, ou excluí-la se não existia.

Importante

Reverter essa chave de Registro é importante. Essa é uma chave de compatibilidade. Não reverter essa alteração pode causar problemas com outros aplicativos .NET que são executados no computador).

Aviso

Ao usar o ComSvcConfig.exe /install em um computador com Windows 8, uma caixa de diálogo é exibida declarando "Um aplicativo em seu PC precisa do seguinte recurso do Windows: .NET Framework 3.5 (inclui o .NET 2.0 e o .NET 3.0" se o .NET Framework 3.5 não estiver instalado. Essa caixa de diálogo pode ser ignorada. Como alternativa, você pode definir a chave do Registro OnlyUseLatestCLR para um valor DWORD de 0x00000001

Adicionar uma interface usando o modo de hospedagem COM+

Execute ComSvcConfig usando as opções /install e /hosting:complus, conforme mostrado no exemplo a seguir.
```
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
```
O comando adiciona a interface IFinances do componente ItemOrders.IFinancial (do aplicativo OnlineStore COM+) ao conjunto de interfaces que serão expostas como serviços Web. O serviço usa o modo de hospedagem COM+ e, portanto, exige a ativação explícita do aplicativo.

Embora o caractere de asterisco curinga (*) possa ser usado para o componente e a interface, evite usá-lo porque você pode querer expor apenas a funcionalidade selecionada como um serviço Web. Se for executado com uma versão futura desse componente, usar o curinga pode sem querer expor interfaces que podem não terem estado presentes quando a sintaxe de configuração foi determinada.

A opção /verbose instrui a ferramenta para exibir avisos além dos erros.

O contrato para o serviço exposto conterá todos os métodos da interface IFinances.

Adicionar métodos específicos de uma interface usando o modo de hospedagem COM+

Execute ComSvcConfig usando as opções /install e /hosting:complus com nomeação explícita dos métodos necessários, conforme mostrado no exemplo a seguir.
```
ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances.{Credit,Debit} /hosting:complus /verbose
```
O comando só pode adicionar os métodos Credit e Debit da interface IFinances como operações para o contrato de serviço exposto. Todos os outros métodos na interface serão omitidos do contrato e não estarão acessíveis para os clientes de serviço Web.

Adicionar uma interface usando o modo de hospedagem Web

Execute ComSvcConfig usando as opções /install e /hosting:was, conforme mostrado no exemplo a seguir.
```
ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse /mex /verbose
```
O comando adiciona a interface IStockLevels no componente ItemInventory.Warehouse (do aplicativo OnlineWarehouse COM+) ao conjunto de interfaces que serão expostas como serviços Web. O serviço Web está hospedado no diretório virtual OnlineWarehouse do IIS em vez de no COM+ e, portanto, o aplicativo é ativado automaticamente conforme o necessário.

Para usar a configuração no processo hospedada na Web, o aplicativo COM+ deve ser configurado para ser executado como um aplicativo de biblioteca em vez de um aplicativo de servidor usando o console de administração Serviços de Componentes. Os aplicativos configurados como aplicativos de servidores usam o modo hospedado na Web padrão e implicam em um salto de processo para processar cada solicitação.

A opção /mex adiciona um ponto de extremidade de serviço adicional do Metadata Exchange (MEX) que use o mesmo transporte que o ponto de extremidade do serviço do aplicativo para dar suporte aos clientes que querem recuperar uma definição de contrato do serviço.

Remover um serviço Web para uma interface especificada

Execute ComSvcConfig usando a opção /uninstall, conforme mostrado no exemplo a seguir.
```
ComSvcConfig.exe /uninstall /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus
```
O comando remove a interface IFinances no componente ItemOrders.Financial (do aplicativo OnlineStore COM+).

Listar as interfaces expostas no momento

Execute ComSvcConfig usando a opção /list, conforme mostrado no exemplo a seguir.
```
ComSvcConfig.exe /list
```
O comando lista as interfaces expostas no momento, junto com o endereço de correspondência e os detalhes da associação, no escopo do computador local.

Listar as interfaces específicas expostas no momento

Execute ComSvcConfig usando a opção /list, conforme mostrado no exemplo a seguir.
```
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus
```
O comando lista as interfaces hospedadas no host COM+ expostas no momento, junto com o endereço de correspondência e os detalhes da associação, para o aplicativo OnlineStore COM+ no computador local.

Exibir ajuda para opções

Executar ComSvcConfig usando a opção /?, conforme mostrado no exemplo a seguir.
```
ComSvcConfig.exe /?
```

Confira também

Visão geral da integração de aplicativos COM+

Compartilhar via