Category Property

Microsoft SQL Server의 이후 버전에서는 이 기능이 제거됩니다. 새 개발 작업에서는 이 기능을 사용하지 않도록 하고, 현재 이 기능을 사용하는 응용 프로그램은 수정하십시오.

The Category property represents the name of a category for SQL Server Agent alerts, jobs, and operators.

구문

object.Category [=value]

Parts

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

  • value
    Specifies a SQL Server Agent category by name. A SQL Server Agent category name can contain a maximum of 100 characters.

Data Type

String

Modifiable

Read/write. When setting the property for an Alert, Job, or Operator object, the value must reference an existing SQL Server Agent alert, job, or operator category.

Prototype (C/C++)

HRESULT GetCategory(SQLDMO_LPBSTR pRetVal);
HRESULT SetCategory(SQLDMO_LPCSTR NewVal);

[!참고]

SQL Distributed Management Objects (SQL-DMO) strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference using SysFreeString.

주의

Microsoft SQL Server alert, job, and operator categories group SQL Server Agent objects. The Category property of SQL-DMO Alert, Job, and Operator objects references the applicable SQL Server Agent category.

Setting the Category property for the JobFilter object restricts listed SQL Server Agent jobs to those having the category when using the EnumJobs method of the JobServer object.