LastOccurrenceDate Property

SQL-DMO

SQL-DMO

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.

See Also

LastOccurrenceTime Property