Share via


LastOccurrenceDate 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 LastOccurrenceDate property identifies the most recent date on which a SQL Server Agent alert was raised.

Syntax

object.LastOccurrenceDate [=value]

Parts

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

  • value
    A date value that specifies day and time

Data Type

Date

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetLastOccurrenceDate(LPLONG pRetVal);
HRESULT SetLastOccurrenceDate(long NewValue);

Note

For C/C++, two SQL Distributed Management Objects (SQL-DMO) functions implement the LastOccurrenceDate property. The GetLastOccurrenceDate and SetLastOccurrenceDate functions represent only the date portion of the SQL Server Agent alert occurrence date. The time portion is represented by the LastOccurrenceTime property.

Remarks

If SQL-DMO uses a scaled long integer to represent a date, the integer is built as a sum of the year scaled by 10000, the month scaled by 100, and the day. For example, the date April 19, 1997 is represented by the long integer value 19970419.

SQL Server Agent maintains historical data for alerts raised and handled by the agent. The date of last occurrence is one piece of historical information maintained.

Applies To:

See Also

Reference