The EnumSnapshotAgentSessionDetails method returns a QueryResults object enumerating detail information for a specified Snapshot Agent session.
object.EnumSnapshotAgentSessionDetails( AgentName,
SessionID ) as QueryResults
| Part | Description |
|---|---|
| object | Expression that evaluates to an object in the Applies To list. |
| AgentName | String identifying a Snapshot Agent by name. |
| SessionID | String identifying a session. The SessionID value is specified by using the first 21 characters of the time column value in the QueryResults result set returned by the EnumSnapshotAgentSessions method. |
A QueryResults object containing one result set defined by these columns.
| Column | Data type | Description |
|---|---|---|
| runstatus | integer | Executing state. Interpret by using SQLDMO_TASKSTATUS_TYPE. |
| time | nvarchar(26) | Date and time of message logging. |
| comments | nvarchar(256) | Descriptive text. |
| duration | integer | Elapsed time of the session. |
| delivery_rate | float | Average number of commands delivered per second. |
| delivered_commands | integer | Cumulative number of commands delivered in the session. |
| name | nvarchar(101) | Agent session name. |
| error_id | integer | When nonzero, Microsoft® SQL Server™ error message number. |
In the result set, date and time data returned in time is formatted as YYYYMMDD hh:mm:ss.fff where: 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; hh represents the hour using two digits, a twenty-four hour clock and zero padding; mm represents the minute in two digits (zero padded); ss represents the second in two digits (zero padded); and fff represents the fractional part of the second in three digits.
HRESULT EnumSnapshotAgentSessionDetails(
SQLDMO_LPCSTR AgentName,
SQLDMO_LPCSTR SessionID,
LPSQLDMOQUERYRESULTS* ppResults);