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.