LastOccurrenceDate Property
The LastOccurrenceDate property identifies the most recent date on which a SQL Server Agent alert was raised.
Applies To
Alert Object |
Syntax
object.LastOccurrenceDate [= value]
Parts
object
Expression that evaluates to an object in the Applies To list
value
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-DMO functions implement the LastOccurrenceDate property. The GetLastOccurrenceDate and SetLastOccurrenceDate functions represent only the date portion of the SQLServerAgent 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.
Remarks
SQLServerAgent maintains historical data for alerts raised and handled by the agent. The date of last occurrence is one piece of historical information maintained.