IServerObjectAdmin.StopConfiguration Method

Stops a server object configuration and shuts down any running instances of server objects defined by the configuration.

[Visual Basic .NET]
Public Sub StopConfiguration ( _
    ByVal Name As String, _
    ByVal TypeName As String _
)

[C#]
public void StopConfiguration (
    string Name,
    string TypeName
);

[C++]
HRESULT StopConfiguration(
  BSTR Name,
  BSTR TypeName
);

[C++]
Parameters
Name [in]
  Name is a parameter of type BSTR
TypeName [in]
  TypeName is a parameter of type BSTR

Product Availability

Description

The StopConfiguration method stops a server object configuration. Stopping a server object configuration both makes the server object configuration unusable by clients (calls to CreateServerObject referencing the configuration will fail), and it also shuts down any of the confiuration's running server objects. If any of those objects are in use and executing requests, they will be interupted and shut down.

You should stop a configuration when you need to change its properties (such as pooling model or recycling model). Use the StartConfiguration method to re-start the configuration.

If you want to stop the confuguration without interupting clients which are making use of server objects, you can pause the configuration using PauseConfiguration and wait until such a time that all server object usage has ended, then call StopConfiguration to stop the configuration.

See Also