EnumNotifications 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 EnumNotifications method returns a QueryResults object that enumerates notifications for a Microsoft SQL Server Agent operator or alert.
Syntax
object
.EnumNotifications(
NotifyMethod
,
EnumNotifyType
,
[ AlertOrOperator ] ) as QueryResults
Parts
- object
Expression that evaluates to an object in the Applies To list.
- NotifyMethod
Long integer that specifies a notification method and directing result set construction as described in Settings.
- EnumNotifyType
Long integer that directs enumeration as described in Settings.
- AlertOrOperator
Optional. String that specifies a notification target or source by name. When using the AlertOrOperator argument, the EnumNotifyType argument must specify SQLDMOEnumNotify_Target.
Prototype (C/C++)
HRESULT EnumNotifications(
SQLDMO_NOTIFY_TYPE NotifyMethod,
SQLDMO_ENUMNOTIFY_TYPE EnumNotifyType,
LPSQLDMOQUERYRESULTS *ppResults,
SQLDMO_LPCSTR AlertOrOperator = NULL);
Settings
The NotifyMethod argument is a bit-packed long integer. Use an OR logical operator to specify more than a single value. Set the NotifyMethod argument using these values.
| 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_Pager |
2 |
Notification by e-mail sent to the operator pager address. |
Set the EnumNotifyType argument using these values.
| Constant | Value | Description |
|---|---|---|
SQLDMOEnumNotify_/Actual |
2 |
Return only those operators or alerts configured for notification. |
SQLDMOEnumNotify_All |
1 |
Return all operators or alerts. The value of the use_email, use_netsend, or use_pager column indicates that the operator or alert is configured for notification by the indicated method. |
SQLDMOEnumNotify_Max |
3 |
SQLDMOEnumNotify_Target. |
SQLDMOEnumNotify_Min |
1 |
SQLDMOEnumNotify_All. |
SQLDMOEnumNotify_/Target |
3 |
Return a result set that enumerates notification for the operator or alert specified in the AlertOrOperator argument. |
Returns
For the Alert object, the EnumNotifications method returns a QueryResults object that contains one result set defined by these columns.
| Column | Data type | Description |
|---|---|---|
has_email |
integer |
When 1, the operator is configured with an e-mail address. |
has_netsend |
integer |
When 1, the operator is configured with an address for network pop-up message receipt. |
has_pager |
integer |
When 1, the operator is configured with a pager address. |
operator_id |
integer |
System-generated operator identifier. |
operator_name |
nvarchar(129) |
Operator name. |
use_email |
integer |
Column present when NotifyMethod specifies SQLDMONotify_Email. When 1, the operator is configured to receive notification by e-mail. |
use_netsend |
integer |
Column present when NotifyMethod specifies SQLDMONotify_NetSend. When 1, the operator is configured to receive notification by network pop-up message. |
use_pager |
integer |
Column present when NotifyMethod specifies SQLDMONotify_Pager. When 1, the operator is configured to receive notification by page. |
For the Operator object, the EnumNotifications method returns a QueryResults object that contains one result set defined by these columns.
| Column | Data type | Description |
|---|---|---|
alert_id |
integer |
System-generated alert identifier. |
alert_name |
nvarchar(129) |
Alert name. |
has_email |
integer |
When nonzero, the number of operators configured to receive alert notification by e-mail. |
has_netsend |
integer |
When nonzero, the number of operators configured to receive alert notification by network pop-up message. |
has_pager |
integer |
When nonzero, the number of operators configured to receive alert notification by pager. |
use_email |
integer |
Column present when NotifyMethod specifies SQLDMONotify_Email. When 1, the alert is configured to raise notification by e-mail. |
use_netsend |
integer |
Column present when NotifyMethod specifies SQLDMONotify_NetSend. When 1, the alert is configured to raise notification by network pop-up message. |
use_pager |
integer |
Column present when NotifyMethod specifies SQLDMONotify_Pager. When 1, the alert is configured to raise notification by page. |