The EnumDistributionAgentSessionDetails method returns a QueryResults object that enumerates detail information for a specified Distribution Agent session.
object.EnumDistributionAgentSessionDetails( AgentName,
SessionID ) as QueryResults
object
Expression that evaluates to an object in the Applies To list.
AgentName
String that identifies a Distributor Agent session by name.
SessionID
String that identifies a session. The SessionID value is specified using the first 21 characters of the time column value in the QueryResults result set returned by the EnumDistributionAgentSessions method.
HRESULT EnumDistributionAgentSessionDetails(
SQLDMO_LPCSTR AgentName,
SQLDMO_LPCSTR SessionID,
LPSQLDMOQUERYRESULTS* ppResults);
A QueryResults object that contains one result set defined by these columns.
| Column | Data type | Description |
|---|---|---|
| integer | Reserved. Always returns 0. | |
| average_commands | integer | Average number of commands per transaction delivered in the session. |
| comments | nvarchar(256) | Descriptive text. |
| delivered_commands | integer | Cumulative number of commands delivered in the session. |
| delivered_transactions | integer | Cumulative number of transactions delivered in the session. |
| delivery_latency | integer | Latency, in milliseconds, between the transaction entering the distribution database and being applied to the Subscriber. |
| delivery_rate | float | Average number of commands delivered per second. |
| duration | integer | Elapsed time of the logged session activity in seconds. |
| error_id | integer | When nonzero, Microsoft® SQL Server™ 2000 error message number. |
| runstatus | integer | Executing state. Interpret using SQLDMO_TASKSTATUS_TYPE. |
| time | nvarchar(26) | Time of logging for session detail. |
In the result set, date and time data returned in time is formatted as YYYYMMDD hh:mm:ss.fff.
| Date part | Description |
|---|---|
| YYYY | Represents the year in four digits |
| MM | Represents the month in two digits (zero padded) |
| DD | Represents the day of the month in two digits (zero padded) |
| hh | Represents the hour using two digits, a twenty-four hour clock (zero padded) |
| mm | Represents the minute in two digits (zero padded) |
| ss | Represents the second in two digits (zero padded) |
| fff | Represents the fractional part of the second in three digits |
For example, the value 19990911 18:12:00.000 is interpreted as 6:12 P.M., September 11, 1999.