Metoda ReadAgentOffloadInfo
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.
ReadAgentOffloadInfo Metoda pobiera informacje o stanie wyładunku agenta z dystrybutorem.
Składnia
object
.ReadAgentOffloadInfo(
bstrJobID
,
pbAgentOffload
,
pszServerNetworkName
,
pbIndependentAgent
)
Części
obiekt
Wyrażenie, którego wartością obiekt na liście dotyczy.bstrJobID
Ciąg określający identyfikator replikacja agenta zadanie.pbAgentOffload
wartość logiczna, zwraca wartość PRAWDA lub FAŁSZ, w zależności od tego, czy agent działa na dystrybutora lub abonenta.pszServerNetworkName
Ciąg, który zwraca nazwę komputera sieciowego subskrybenta.pbIndependentAgent
wartość logicznazwracającą wartość PRAWDA lub FAŁSZ, w zależności od tego, czy agent jest niezależne lub udostępnione.
Prototyp (C/C++)
HRESULT ReadAgentOffloadInfo(
SQLDMO_LPCSTR pszJobID,
LPBOOL pbAgentOffload,
SQLDMO_LPBSTR pszServerNetworkName,
LPBOOL pbIndependentAgent);
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ć odniesienia przy użyciu SysFreeString.
Uwagi
Użyj ReadAgentOffloadInfo metoda z bstrJobID parametr, który określa identyfikator zadanie agenta replikacja, aby pobrać informacje o stanie wyładunku agenta.Jeśli pbAgentOffload zwraca wartość TRUE, agent jest uruchamiany przez subskrybenta.Jeśli pbAgentOffload zwraca wartość FALSE, agent jest uruchamiany na dystrybutora.Jeśli pbIndependentAgent zwraca wartość TRUE, agent funkcje jako niezależny agent.Jeśli pbIndependentAgent zwraca wartość FALSE, agent funkcje jako agent udostępnionych.
Użyj EnableAgentOffload lub DisableAgentOffload metod, aby zmienić stan wyładunku agenta.
Ostrzeżenie
Jeśli aplikacja wywoła ReadAgentOffloadInfo 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.