IServerObjectAdmin.PauseConfiguration Method

Makes the configuration unavailable to clients for processing requests, but does not shut down running instances of server objects, or interrupt requests in progress.

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

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

[C++]
HRESULT PauseConfiguration(
  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

Remarks

The PauseConfiguration method will pause the server object configuration. Pausing the configuration does not interupt any requests that are being executed by instances of server objects managed by that configuration. A paused server object, hevever, will refuse future requests.

You should pause server objects if you want to lock requests from being processed, but you want requests in process to complete. Once all objects are not longer in use, you can perform necessary operations (such as database maintenance, stopping the server object configuration to changes properties, etc). Use the GetConfigurationStatus and IServerObjectConfigurationStatus to determine if any server objects are in use.

Use the StartConfiguration method to resume the server object configuration. 

See Also

.NET Samples