Procedure: Het com+-servicemodelconfiguratieprogramma gebruiken

Zodra u een geschikte hostingmodus hebt geselecteerd, gebruikt u het opdrachtregelprogramma COM+ Service Model Configuration (ComSvcConfig.exe) om de toepassingsinterfaces te configureren die worden weergegeven als webservices.

Notitie

U moet een beheerder op de computer zijn om een van de volgende taken uit te voeren.

Wanneer u ComSvcConfig.exe op een Windows 7-computer gebruikt om een webservice te configureren voor het gebruik van de nieuwste versie van het servicemodel (momenteel v4.5), voert u de volgende stappen uit:

1. Stel de registersleutel [HKEY_LOCAL_COMPUTER\SOFTWARE\Microsoft\.NETFramework]\OnlyUseLatestCLR in op een DWORD-waarde van 0x00000001

2. Comsvcconfig.exe uitvoeren

3. Zet de registersleutel terug die in stap 1 is toegevoegd aan de oorspronkelijke waarde of verwijder deze als deze niet bestond.

Belangrijk

Het terugdraaien van deze registersleutel is belangrijk. Dit is een compatibiliteitssleutel. Als u deze wijziging niet ongedaan maakt, kan dit problemen veroorzaken met andere .NET-toepassingen die op de computer worden uitgevoerd).

Waarschuwing

Wanneer u ComSvcConfig.exe /install op een Windows 8-computer gebruikt, wordt een dialoogvenster weergegeven met de tekst 'Een app op uw pc heeft de volgende Windows-functie nodig: .NET Framework 3.5 (inclusief .NET 2.0 en .NET 3.0' als .NET Framework 3.5 niet is geïnstalleerd. Dit dialoogvenster kan worden genegeerd. U kunt ook de registersleutel OnlyUseLatestCLR naar een DWORD-waarde van 0x00000001

Een interface toevoegen met behulp van de COM+-hostingmodus

• Voer ComSvcConfig uit met behulp van de /install en /hosting:complus opties, zoals wordt weergegeven in het volgende voorbeeld.

  ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus /verbose
  

  Met de opdracht wordt de IFinances interface van het ItemOrders.IFinancial onderdeel (van de OnlineStore COM+-toepassing) toegevoegd aan de set interfaces die als webservices worden weergegeven. De service maakt gebruik van de COM+-hostingmodus en vereist daarom expliciete toepassingsactivering.

  Hoewel het jokerteken sterretje (*) kan worden gebruikt voor het onderdeel en de interface, vermijdt u het gebruik ervan omdat u mogelijk alleen geselecteerde functionaliteit als een webservice beschikbaar wilt maken. Als deze wordt uitgevoerd met een toekomstige versie van dit onderdeel, kan met behulp van het jokerteken onbedoeld interfaces worden weergegeven die mogelijk niet aanwezig zijn toen de configuratiesyntaxis werd bepaald.

  Met de optie /uitgebreid wordt het hulpprogramma geïnstrueerd om naast eventuele fouten waarschuwingen weer te geven.

  Het contract voor de weergegeven service bevat alle methoden van de IFinances interface.

Specifieke methoden toevoegen vanuit een interface met behulp van de COM+-hostingmodus

• Voer ComSvcConfig uit met behulp van de /install en /hosting:complus opties met expliciete naamgeving van de vereiste methoden, zoals wordt weergegeven in het volgende voorbeeld.

  ComSvcConfig.exe /install /application:OnlineStore /contract:ItemOrders.Financial,IFinances.{Credit,Debit} /hosting:complus /verbose
  

  Met de opdracht worden alleen de Credit en Debit methoden van de IFinances interface toegevoegd als bewerkingen aan het weergegeven servicecontract. Alle andere methoden op de interface worden weggelaten uit het contract en kunnen niet worden aangeroepen vanuit webserviceclients.

Een interface toevoegen met behulp van de webhostingmodus

• Voer ComSvcConfig uit met behulp van de /install optie en de /hosting:was optie, zoals wordt weergegeven in het volgende voorbeeld.

  ComSvcConfig.exe /install /application:OnlineWarehouse /contract:ItemInventory.Warehouse,IStockLevels /hosting:was /webDirectory:root/OnlineWarehouse /mex /verbose
  

  Met de opdracht wordt de IStockLevels interface aan het ItemInventory.Warehouse onderdeel (van de OnlineWarehouse COM+-toepassing) toegevoegd aan de set interfaces die als webservices worden weergegeven. De service wordt gehost in de virtuele map OnlineWarehouse van IIS in plaats van in COM+, waardoor de toepassing automatisch wordt geactiveerd als vereist.

  Als u de configuratie van de web-hostende in-proces wilt gebruiken, moet de COM+-toepassing worden geconfigureerd om te worden uitgevoerd als een bibliotheektoepassing in plaats van als een servertoepassing met behulp van de beheerconsole van Component Services. Toepassingen die zijn geconfigureerd als Server-toepassingen maken gebruik van de standaardmodus die wordt gehost op het web en maken een proceshop om elke aanvraag te verwerken.

  Met /mex de optie wordt een extra MEX-service-eindpunt (Metadata Exchange) toegevoegd dat gebruikmaakt van hetzelfde transport als het service-eindpunt van de toepassing ter ondersteuning van clients die een contractdefinitie uit de service willen ophalen.

Een webservice voor een opgegeven interface verwijderen

• Voer ComSvcConfig uit met behulp van de /uninstall optie, zoals wordt weergegeven in het volgende voorbeeld.

  ComSvcConfig.exe /uninstall /application:OnlineStore /contract:ItemOrders.Financial,IFinances /hosting:complus
  

  Met de opdracht wordt de IFinances interface van het ItemOrders.Financial onderdeel verwijderd (uit de OnlineStore COM+-toepassing).

Lijst met momenteel weergegeven interfaces

• Voer ComSvcConfig uit met behulp van de /list optie, zoals wordt weergegeven in het volgende voorbeeld.

  ComSvcConfig.exe /list
  

  Met de opdracht worden de momenteel weergegeven interfaces weergegeven, samen met de bijbehorende adres- en bindingsgegevens, die zijn afgestemd op de lokale computer.

Lijst met specifieke momenteel weergegeven interfaces

• Voer ComSvcConfig uit met behulp van de /list optie, zoals wordt weergegeven in het volgende voorbeeld.

  ComSvcConfig.exe /list /application:OnlineStore /hosting:complus
  

  Met de opdracht worden momenteel com+-gehoste interfaces weergegeven, samen met het bijbehorende adres en de bijbehorende bindingsgegevens, voor de OnlineStore COM+ toepassing op de lokale computer.

Help weergeven voor opties

• ComSvcConfig uitvoeren met behulp van de /? optie, zoals wordt weergegeven in het volgende voorbeeld.

  ComSvcConfig.exe /?
  

Zie ook

• Overzicht van integratie met COM+-toepassingen