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

Artigo
03/02/2024

Depois de selecionar um modo de hospedagem apropriado, use a ferramenta de linha de comando COM+ Service Model Configuration (ComSvcConfig.exe) para configurar as interfaces de aplicativo que serão expostas como serviços Web.

Nota

Você deve ser um administrador na máquina para executar qualquer uma das seguintes tarefas.

Ao usar ComSvcConfig.exe em uma máquina 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 [HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLR do Registro como um valor DWORD de 0x00000001
Executar comsvcconfig.exe
Reverta a chave do Registro adicionada na etapa 1 de volta ao seu valor original ou exclua-a se não existir.

Importante

É importante reverter essa chave do Registro. Esta é uma chave de compatibilidade. Não reverter essa alteração pode causar problemas com outros aplicativos .NET em execução no computador).

Aviso

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

Adicionar uma interface usando o modo de hospedagem COM+

Execute ComSvcConfig usando as /install opções 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 IFinances interface do ItemOrders.IFinancial componente (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, requer ativação explícita do aplicativo.

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

A opção /verbose instrui a ferramenta a exibir avisos, além de quaisquer erros.

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

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

Execute ComSvcConfig usando as /install opções e /hosting:complus com nomenclatura 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 adiciona apenas os métodos e Debit da CreditIFinances interface como operações ao contrato de serviço exposto. Todos os outros métodos na interface serão omitidos do contrato e não poderão ser chamados a partir de clientes de serviços Web.

Adicionar uma interface usando o modo de hospedagem na Web

Execute ComSvcConfig usando a /install opção e a /hosting:was opção, 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 IStockLevels interface no ItemInventory.Warehouse componente (do aplicativo OnlineWarehouse COM+) ao conjunto de interfaces que serão expostas como serviços Web. O serviço é hospedado na Web no diretório virtual OnlineWarehouse do IIS em vez de em COM + e, portanto, o aplicativo é ativado automaticamente conforme necessário.

Para usar a configuração em 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 dos Serviços de Componentes. Os aplicativos configurados como aplicativos de servidor usam o modo padrão hospedado na Web e incorrem em um salto de processo para processar cada solicitação.

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

Remover um serviço Web para uma interface especificada

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

Listar interfaces atualmente expostas

Execute ComSvcConfig usando a /list opção, conforme mostrado no exemplo a seguir.
```
ComSvcConfig.exe /list
```
O comando lista as interfaces atualmente expostas, juntamente com o endereço correspondente e os detalhes de ligação, com escopo para a máquina local.

Listar interfaces específicas atualmente expostas

Execute ComSvcConfig usando a /list opção, conforme mostrado no exemplo a seguir.
```
ComSvcConfig.exe /list /application:OnlineStore /hosting:complus
```
O comando lista as interfaces hospedadas em COM+ atualmente expostas, juntamente com o endereço correspondente e os detalhes de ligação, para o aplicativo COM+ da Loja Online na máquina local.

Exibir ajuda para opções

Execute ComSvcConfig usando o /? , conforme mostrado no exemplo a seguir.
```
ComSvcConfig.exe /?
```

Consulte também

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

Partilhar via