EnumJobNotifications 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 EnumJobNotifications method returns a QueryResults object that enumerates notifications made by Microsoft SQL Server Agent on completion of job execution.

Syntax

object.EnumJobNotifications as QueryResults

Parts

  • object
    Expression that evaluates to an object in the Applies To list.

Prototype (C/C++)

HRESULT EnumJobNotifications(
LPSQLDMOQUERYRESULTS *ppResults);

Returns

The EnumJobNotifications method returns a QueryResults object that contains one result set defined by these columns.

Column name

Data type

Description

job_id

uniqueidentifier

System-generated identifier for a SQL Server Agent job.

name

nvarchar(129)

Job name.

notify_level_email

integer

Job completion status causing notification by e-mail. Interpret as described in Remarks.

notify_level_/netsend

integer

Job completion status causing notification by network pop-up message. Interpret as described in Remarks.

notify_level_page

integer

Job completion status causing notification by pager. Interpret as described in Remarks.

Remarks

Interpret values returned in value returned in the notify_level_email, notify_level_netsend, and notify_level_page columns using these values.

Value

Description

0

Operator not configured for notification by notification method.

1

Operator receives notification of a successful job execution.

2

Operator receives notification of an unsuccessful execution attempt.

3

Operator receives notification regardless of execution outcome.

The result set returned enumerates all jobs for which an operator will receive notification on execution attempt completion. At least one of the columns notify_level_email, notify_level_netsend, or notify_level_page will contain a non-zero value for all rows in the result set.

Applies To: