CurrentValue Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The CurrentValue property specifies a configuration parameter value for a point in time.

Syntax

object.CurrentValue [=value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list

  • value
    A long integer

Data Type

Long

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetCurrentValue(LPLONG pRetVal);
HRESULT SetCurrentValue(LONG NewValue);

Remarks

Modify the CurrentValue property to change Microsoft SQL Server configuration parameter values. The MinimumValue and MaximumValue properties provide the range of values acceptable for the CurrentValue property.

Setting the CurrentValue property does not change the value of the configuration parameter. If the DynamicReconfigure property is TRUE, use the ReconfigureCurrentValues or ReconfigureWithOverride method of the Configuration object to apply the change. If DynamicReconfigure is FALSE, the server must be restarted to apply the change.

Applies To: