Metoda GetAgentsStatus2 (DistributionPublication2, DistributionPublisher2)
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.
GetAgentsStatus2 Metoda zwraca wysokiego poziom raportu stan wykonania agenci replikacja wykonawczych publikacji Wydawca.
Składnia
object
.GetAgentsStatus2(
fExcludeAnonymous
,
pRetValStatus
,
pRetValTimeStamp
)
Części
obiekt
Wyrażenie, którego wartością obiekt na liście dotyczy.fExcludeAnonymous
Wartość logiczna określająca, czy stan z subskrypcjami anonimowe jest wyłączone.pRetVal
Wyliczone długa wartość zwracana.pRetValTimeStamp
Zwracana wartość ciągu.
Prototyp (C/C++)
HRESULT GetAgentsStatus2(
BOOL fExcludeAnonymous,
SQLDMO_TASKSTATUS_TYPE *pRetVal,
SQLDMO_LPBSTR pRetValTimeStamp);
Zwraca
Interpretuje wartość zwracana w ReturnedStatus argument za pomocą tych wartości SQLDMO_TASKSTATUS_TYPE.
Stała |
Wartość |
Opis |
|---|---|---|
SQLDMOTask_Failed |
6 |
Pomyślnie wykonać co najmniej jednego zadanie wykonawcze agenta nie powiodło się. |
SQLDMOTask_Idle |
4 |
Wszystkie zadania wykonawcze agenta są planowane i bezczynności. |
SQLDMOTask_Pending |
0 |
Wszystkie zadania wykonawcze agenta oczekuje na uruchomienie. |
SQLDMOTask_Retry |
5 |
Co najmniej jednego zadanie wykonawcze agenta próbuje wykonać po poprzednim błędzie. |
SQLDMOTask_Running |
3 |
Co najmniej jednego zadanie wykonawcze agenta jest wykonywana. |
SQLDMOTask_Starting |
1 |
Jeden lub więcej zadań wykonawczych agent jest uruchamiany. |
SQLDMOTask_Succeeded |
2 |
Wszystkie zadania wykonawcze agent zostały prawidłowo wykonane. |
Sygnatury czasowej zwraca wartość argumentu timestamp wartości (binarnych) jako ciąg znaków szesnastkowych.
Uwagi
GetAgentsStatus2 metoda rozszerza funkcjonalność GetAgentsStatus metoda włącznie z fExcludeAnonymous parametru.Gdy fExcludeAnonymous jest zestaw ma wartość TRUE, subskrypcje anonimowe nie są wyliczone.
Korzystając z programu Microsoft Visual Basic jako środowiska programowania aplikacji SQL Distributed Management Objects (SQL-DMO), należy użyć składni instrukcja wywołanie podprocedury wykonać GetAgentsStatus metoda pomyślnie.
Ostrzeżenie
SQL-DMO ciągi 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.
Ostrzeżenie
Jeśli aplikacja wywoła GetAgentsStatus2 na wystąpienie wersja programu SQL Server 7.0, stała, SQLDMO_E_SQL80ONLY i komunikat "Ta właściwość lub metoda wymaga Microsoft SQL Server 2000 lub nowszy" są zwracane.