Share via


FrequencyRecurrenceFactor 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 FrequencyRecurrenceFactor property controls evaluation of the most significant portion of a Microsoft SQL Server schedule.

Syntax

object
.FrequencyRecurrenceFactor [=value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list.
  • value
    A long integer greater than or equal to 1 and indicating a number of weeks or months.

Data Type

Long

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetFrequencyRecurrenceFactor(LPLONG pRetVal);
HRESULT SetFrequencyRecurrenceFactor(LONG NewValue);

Remarks

The FrequencyRecurrenceFactor property is evaluated for Schedule objects with FrequencyType values of SQLDMOFreq_Monthly, SQLDMOFreq_MonthlyRelative, or SQLDMOFreq_Weekly.

The FrequencyRecurrenceFactor property indicates a number of units of the unit type indicated by the FrequencyType property. For example, if FrequencyType is SQLDMOFreq_Weekly, FrequencyRecurrenceFactor indicates a number of weeks. Setting FrequencyRecurrenceFactor to 2 indicates an activity scheduled to occur every other week.

FrequencyType value Action

SQLDMOFreq_Monthly

Sets FrequencyInterval to indicate the day of the month on which the activity occurs.

SQLDMOFreq_MonthlyRelative

Sets FrequencyInterval to indicate the single day of the week on which the activity occurs. Sets FrequencyRelativeInterval to indicate the day of the week relative to the start of the month.

SQLDMOFreq_Weekly

Sets FrequencyInterval to indicate the day or days of the week on which the activity occurs.

Applies To:

Schedule Object