AddNotification Method
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 AddNotification method associates operators with alerts. Operators designated receive notification messages when an event raising the alert occurs.
Syntax
object.AddNotification(str ,NotificationType)
Parts
object
Expression that evaluates to an object in the Applies To list.str
String that specifies a Microsoft SQL Server Agent operator or alert by name.NotificationType
Long integer that specifies a method for notification message delivery as described in Settings.
Prototype (C/C++)
HRESULT AddNotification(
SQLDMO_LPCSTR strAlertOrOperator,
SQLDMO_NOTIFY_TYPE NotifyMethod);
Settings
The NotificationType argument is a bit-packed, long integer value. Specify more than a single notification method by combining values using the OR logical operator.
Constant |
Value |
Description |
---|---|---|
SQLDMONotify_All |
7 |
Notification by e-mail, e-mail sent to the pager address, and network pop-up message. |
SQLDMONotify_Email |
1 |
Notification by e-mail sent to the operator e-mail address. |
SQLDMONotify_NetSend |
4 |
Notification by network pop-up message posted to the operator network address. |
SQLDMONotify_None |
0 |
No notification method specified for the referenced operator. |
SQLDMONotify_Pager |
2 |
Notification by e-mail sent to the operator pager address. |
Remarks
The AddNotification method can be used to add an alert to the list of alerts that generate operator notification, or an operator to the list of those notified when the alert is raised.
For the Alert object, the str argument identifies an operator. For the Operator object, str identifies an alert.