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.