PublisherMonitor.EnumMergeAgentSessions2(String, Int32, Boolean) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
返回关于合并代理会话的额外信息。
public:
System::Data::DataSet ^ EnumMergeAgentSessions2(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);public System.Data.DataSet EnumMergeAgentSessions2(string agentName, int sessionDuration, bool returnOnlyErrorSessions);member this.EnumMergeAgentSessions2 : string * int * bool -> System.Data.DataSetPublic Function EnumMergeAgentSessions2 (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSet参数
- agentName
- String
一个String指定 合并代理 作业名称的值。 你可以利用 SynchronizationAgentName 对象 MergeSubscription 的属性来获得这个值。
- sessionDuration
- Int32
这是一个 Int32 指定当前时间限制时间前的小时数的值。 例如，值为24会返回过去24小时内的代理会话信息。 值为 -1 返回最近100个会话的信息，值为0则返回所有会话的信息。
- returnOnlyErrorSessions
- Boolean
该 Boolean 值指定是只返回导致错误的会话信息，还是所有会话。 如果 true，则只返回错误会话。 如果 false，则所有会话返回。
返回
一个 DataSet 包含以下列的对象。
| 列 | 数据类型 | 说明 |
|---|---|---|
| Session_id | Int32 | 代理作业会话的 ID。 |
| 状态 | Int32 | 特工运行状态： 1 = 开始 2 = 成功 3 = 进行中 4 = 空闲 5 = 重试 6 = 失败 |
| StartTime | DateTime | 代理人工作会议开始。 |
| 终结时间 | DateTime | 代理人工作会话完成的时间。 |
| 持续时间 | Int32 | 代理作业会话的累计持续时间（秒数）。 |
| 上传命令 | Int32 | 代理作业会话中上传的命令数量。 |
| 下载命令 | Int32 | 代理作业会话中下载的命令数量。 |
| 错误消息 | Int32 | 代理作业会话中生成的错误消息数量。 |
| 错误ID | Int32 | 错误的识别 |
| 百分比已完成 | Decimal | 估计在当前会话中已交付的总变更百分比。 |
| 剩余时间 | Int32 | 估计的活动会话所剩秒数。 |
| 当前阶段 | Int32 | 是当前活跃会话的阶段，可以是以下之一： 1 = 上传 2 = 下载 |
| 最后的信息 | String | 是 合并代理 在会话中记录的最后一条消息。 |
注解
在调用此方法之前，你应先提交任何属性更改 PublisherMonitor ，因为如果该对象的属性尚未加载，可能需要被加载。
EnumMergeAgentSessions2该方法只能由分发数据库中或固定数据库角色的成员db_ownerreplmonitor调用。
调用 EnumMergeAgentSessions2 相当于执行 sp_replmonitorhelpmergesession（Transact-SQL）。