Metoda GetAgentsStatus (dystrybutora)
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 dystrybutora.
Składnia
object
.GetAgentsStatus(
AgentType
,
ReturnedStatus
,
TimeStamp
)
Części
obiekt
Wyrażenie, którego wartością obiekt na liście dotyczy.AgentType
Długa liczba całkowita, która określa typ agent replikacja, jak opisano w ustawieniach.ReturnedStatus
Wyliczone długa wartość zwracana.Sygnatura czasowa
Zwracana wartość ciągu.
Prototyp (C/C++)
HRESULT GetAgentsStatus(
SQLDMO_REPLAGENT_TYPE AgentType,
SQLDMO_TASKSTATUS_TYPE* pRetValStatus,
SQLDMO_LPBSTR pRetValTimeStamp = NULL);
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.
Ustawienia
Ustaw AgentType argument za pomocą tych wartości SQLDMO_REPLAGENT_TYPE.
Stała |
Wartość |
Opis |
|---|---|---|
SQLDMOReplAgent_All |
0 |
Wszystkie rodzaje agent replikacja. |
SQLDMOReplAgent_ i dystrybucji |
3 |
Agent dystrybucji. |
SQLDMOReplAgent_ i LogReader |
2 |
Transakcja dziennika monitorowania agent replikacji. |
SQLDMOReplAgent_Merge |
4 |
Scalanie agenta. |
SQLDMOReplAgent_/inne |
5 |
Agenci nie inaczej niejawnych. |
SQLDMOReplAgent_ i wydawców |
-1 |
Agenci wspieranie wydawców. |
SQLDMOReplAgent_ i QueueReader |
9 |
Agent czytnik kolejki replikacji. |
SQLDMOReplAgent_ i migawki |
1 |
Agent migawki. |
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ła wykonana pomyślnie. |
The TimeStamp argument returns a timestamp(binary) value as a hexadecimal character string.
Uwagi
Używając jako środowiska programowania aplikacji SQL-DMO programu Microsoft Visual Basic, należy użyć składni instrukcja wywołanie podprocedury wykonać GetAgentsStatus metoda pomyślnie.
EnumDistributionAgentViews2 metoda rozszerza funkcjonalność GetAgentsStatus metoda.