Instance.Disable Method

  • Article

Sets the state of the instance to Disabled.

Namespace: Microsoft.SqlServer.Management.Nmo
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

Syntax

'Declaration
Public Sub Disable

public void Disable ()

public:
void Disable ()

public void Disable ()

public function Disable ()

Remarks

When you create an instance of Notification Services, the instance and all of its components are disabled.

Disabling an instance of Notification Services prevents all event collection, notification generation, notification distribution, and subscription management. You can disable the instance to pause processing. You must disable the instance before you update it.

The Notification Services engine queries the database for the status of its components every 30 seconds. Until the engine picks up the status change, engine components show a status of Disable Pending.

Example

The following examples show how to disable, unregister, and drop an instance of Notification Services:

// First disable the instance.
Console.WriteLine("Disabling instance...");
inst.Disable();

// Then unregister the instance.
Console.WriteLine("Unregistering instance...");
inst.UnregisterLocal();

// And then delete the instance.
Console.WriteLine("Deleting instance...");
inst.Drop();

Console.WriteLine("Done.");

' First disable the instance.
Console.WriteLine("Disabling instance...")
inst.Disable()

' Then unregister the instance.
Console.WriteLine("Unregistering instance...")
inst.UnregisterLocal()

' And then delete the instance.
Console.WriteLine("Deleting instance...")
inst.Drop()

Console.WriteLine("Done.")

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

Instance Class
Instance Members
Microsoft.SqlServer.Management.Nmo Namespace

Other Resources

Enabling and Disabling Instances, Applications, or Components
Viewing the Status of Instances, Applications, and Components