Udostępnij za pośrednictwem


Właściwości kategorii

Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Należy unikać stosowania tej funkcji w nowych projektach oraz zaplanować modyfikację aplikacji, w których obecnie jest używana ta funkcja.

Category Właściwość reprezentuje nazwę kategorii dla SQL Server alerty agenta, zadania i operatory.

Składnia

object
.Category [=value]

Części

  • object
    Wyrażenie do obiektu w na liście dotyczy.

  • value
    Określa nazwę kategorii agenta programu SQL Server.Nazwa kategorii agenta programu SQL Server może zawierać maksymalnie 100 znaków.

Typ danych

String

Można modyfikować

Odczyt i zapis.Podczas ustawiania właściwość dla Alert, Job, lub Operator obiektu musi odwoływać się wartość istniejącego programu SQL Server Agent alert, zadanie lub operator kategorii.

Prototyp (C/C++)

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

Ostrzeżenie

Ciągi znaków SQL Distributed Management Objects (SQL-DMO) są zawsze zwracane jako obiekty OLE BSTR.Aplikacja c i C++ pobiera odwołanie do ciąg.Aplikacja musi zwolnić, przy użyciu odwołania SysFreeString.

Uwagi

Microsoft SQL Server alert, zadanie i kategorii operator grupować obiekty agenta programu SQL Server.Category właściwość obiektów SQL-DMO Alert, Job, i Operator odwołuje się do obiektów mających zastosowanie kategorii agenta programu SQL Server.

Ustawienie Category dla właściwość JobFilter ogranicza obiektu wymienionych SQL Server zadania agenta do osób mających kategorii podczas korzystania z EnumJobs metoda JobServer obiektu.