LastOccurrenceDate Property (SQL-DMO)

The LastOccurrenceDate property identifies the most recent date on which a SQL Server Agent alert was raised.

Applies To

Syntax

object.LastOccurrenceDate [= value]

Part	Description
object	Expression that evaluates to an object in the Applies To list
value	Date value specifying day and time

Remarks

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.

Data Type

Date

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetLastOccurrenceDate(LPLONG pRetVal);

HRESULT SetLastOccurrenceDate(long NewValue);

Note For C/C++, two 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.

When 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.