Compartir a través de


GetAgentsStatus Method (Distributor)

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

The GetAgentsStatus2 method returns a high level report of execution state for replication agents implementing a Distributor.

Sintaxis

object.GetAgentsStatus( AgentType, ReturnedStatus, TimeStamp)

Parts

  • object
    Expression that evaluates to an object in the Applies To list.

  • AgentType
    Long integer that specifies a type of replication agent as described in Settings.

  • ReturnedStatus
    Enumerated long value returned.

  • TimeStamp
    String value returned.

Prototype (C/C++)

HRESULT GetAgentsStatus(
SQLDMO_REPLAGENT_TYPE AgentType,
SQLDMO_TASKSTATUS_TYPE* pRetValStatus,
SQLDMO_LPBSTR pRetValTimeStamp = NULL);

[!NOTA]

SQL Distributed Management Objects (SQL-DMO) strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference using SysFreeString.

Settings

Set the AgentType argument using these SQLDMO_REPLAGENT_TYPE values.

Constant

Value

Description

SQLDMOReplAgent_All

0

All replication agent types.

SQLDMOReplAgent_/Distribution

3

Distribution Agent.

SQLDMOReplAgent_/LogReader

2

Replication transaction log monitoring agent.

SQLDMOReplAgent_Merge

4

Merge Agent.

SQLDMOReplAgent_/Miscellaneous

5

Agents not otherwise classified.

SQLDMOReplAgent_/Publishers

-1

Agents supporting publishers.

SQLDMOReplAgent_/QueueReader

9

Replication Queue Reader Agent.

SQLDMOReplAgent_/Snapshot

1

Snapshot Agent.

Returns

Interpret the value returned in the ReturnedStatus argument using these SQLDMO_TASKSTATUS_TYPE values.

Constant

Value

Description

SQLDMOTask_Failed

6

At least one agent-implementing job has failed to execute successfully.

SQLDMOTask_Idle

4

All agent-implementing jobs are scheduled and idle.

SQLDMOTask_Pending

0

All agent-implementing jobs are waiting to start.

SQLDMOTask_Retry

5

At least one agent-implementing job is attempting to execute after a previous failure.

SQLDMOTask_Running

3

At least one agent-implementing job is executing.

SQLDMOTask_Starting

1

One or more agent-implementing jobs are starting.

SQLDMOTask_Succeeded

2

All agent-implementing jobs have executed successfully.

The TimeStamp argument returns a timestamp(binary) value as a hexadecimal character string.

Notas

When using Microsoft Visual Basic as a SQL-DMO application development environment, use the subroutine call statement syntax to execute the GetAgentsStatus method successfully.

The GetAgentsStatus2 method extends the functionality of the GetAgentsStatus method.

Applies To:

Vea también

Referencia