Metoda EnumQueueReaderAgentSessionDetails
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.
TheEnumQueueReaderAgentSessionDetails method returns a QueryResults object that enumerates detailed information about a Queue Reader Agent session related to the specified publication.
Składnia
object
.EnumQueueReaderAgentSessionDetails(
lPublicationID
,
SessionID
,
lEstimatedNumRecords
)
as
QueryResults
Części
obiekt
Wyrażenie, którego wartością obiekt na liście dotyczy.lPublicationID
Liczba całkowita długa, identyfikujący publikacja przez identyfikator.Identyfikator sesji
Ciąg identyfikujący sesja agent przez identyfikator.lEstimatedNumRecords
Długa liczba całkowita, która określa szacunkową liczbę QueryResults wiersze.
Prototyp (C/C++)
HRESULT EnumQueueReaderAgentSessionDetails (
long lPublicationID,
SQLDMO_LPCSTR SessionID,
long lEstimatedNumRecords,
LPSQLDMOQUERYRESULTS *ppResults);
Zwraca
A QueryResults obiekt, który zawiera jeden zestaw wyników, określonych przez te kolumny.
Kolumna |
Typ danych |
Opis |
|---|---|---|
commands_processed |
integer |
Skumulowana liczba poleceń przetwarzane w sesja. |
comments |
nvarchar(256) |
Tekst opisowy. |
error_id |
integer |
Niezerowa, oznacza numer komunikatu błędu Microsoft SQL Server. |
runstatus |
integer |
Państwa wykonującego.Interpretować za pomocą SQLDMO_TASKSTATUS_TYPE. |
subscriber |
sysname |
Nazwa subskrybenta. |
subscriberdb |
sysname |
Nazwa baza danych subskrypcja. |
time |
nvarchar(24) |
Data i czas rejestrowania wiadomości. |
transaction_id |
integer |
Identyfikator transakcji. |
transaction_status |
integer |
Bieżący stan transakcji. |
Uwagi
zestaw wyników, Data i czas danych zwracanych w czas sformatowane jako hh:mm:ss.fff RRRRMMDD.
Część daty |
Opis |
|---|---|
RRRR |
Reprezentuje rok cztery cyfry. |
MM |
Reprezentuje miesiąc dwiema cyframi (wyściełane zero). |
DD |
Reprezentuje dzień miesiąca w dwie cyfry (zero wyściełane). |
hh |
Reprezentuje godzinę za pomocą dwóch cyfr zegara 24-godzinnego (wyściełane zero). |
mm |
Reprezentuje minuty w dwie cyfry (zero wyściełane). |
ss |
Reprezentuje drugi w dwie cyfry (zero wyściełane). |
fff |
Reprezentuje część ułamkowa drugi w trzech cyfr. |
Na przykład 18:12:00.000 20040512 wartość jest interpretowana jako 6:12 P.M., dnia 12 maja 2004 r.
EnumQueueReaderAgentSessions Metoda zawiera lEstimatedNumRecords parametr, który pozwala aplikacjom przekazywanie szacunkową liczbę QueryResults wierszy.Umożliwia aplikacji uniknąć wydajności, obciążenie związane z wielokrotnie przydzielania i zwalniania pamięci.
Aby zwiększyć dokładność szacunkową liczbę QueryResults wierszy, aplikacja może przekazać wartość action_count kolumna zwrócone przez EnumQueueReaderAgentSessions metoda lEstimatedNumRecords parametru.
Ostrzeżenie
If an application calls EnumQueueReaderAgentSessionDetailson an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000 or later" are returned.