ReconfigureWithOverride Method (SQL-DMO)

The ReconfigureWithOverride method applies changes to configuration options made by changing the properties of the ConfigValue objects contained in the Configuration object’s ConfigValues collection.

Applies To

Configuration Object

Syntax

object.ReconfigureWithOverride( )

Part Description
object Expression that evaluates to an object in the Applies To list

Remarks

Use the ReconfigureWithOverride method to disable option value validity checking when using the ConfigValue object to set Microsoft® SQL Server™ configuration options.


Important Some configuration option changes applied by setting ConfigValue object properties and using the ReconfigureWithOverride method take effect immediately. Other changes require that the SQL Server service be stopped and restarted. When a change requires service restart, you must first apply the change by using ReconfigureWithOverride, then stop and start the SQL Server service.


Setting configuration options by using the ConfigValue object and ReconfigureWithOverride method requires appropriate privilege. The SQL Server login used for SQLServer object connection must be a member of the fixed server role sysadmin.

Prototype (C/C++)

HRESULT ReconfigureWithOverride();

See Also

ConfigValue Object

  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.