共用方式為

UpdateAgentProfile Method

  • 發行項

未來的 Microsoft SQL Server 發行版本將不再提供此功能。請避免在新的開發工作中使用此功能，並計劃修改目前使用此功能的應用程式。

The UpdateAgentProfile method alters a profile setting for the agent specified.

語法

object
.UpdateAgentProfile(
DistributionDB
,
AgentType
,
AgentID
,
ConfigurationID
)

Parts

  • object
    Expression that evaluates to an object in the Applies To list.
  • DistributionDB
    String.
  • AgentType
    Long integer that specifies a replication agent type as described in Settings.
  • AgentID
    Long integer.
  • ConfigurationID
    Long integer.

Prototype (C/C++)

HRESULT UpdateAgentProfile(
SQLDMO_LPCSTR DistributionDBName,
SQLDMO_REPLAGENT_TYPE AgentType,
long lAgentID,
long lConfigurationID);

Settings

Set the AgentType argument by using these SQLDMO_REPLAGENT_TYPE values.

Constant Value Description

SQLDMOReplAgent_Distribution

3

Replication Distribution Agent.

SQLDMOReplAgent_LogReader

2

Replication transaction log monitoring agent.

SQLDMOReplAgent_Merge

4

Replication Merge Agent.

SQLDMOReplAgent_/QueueReader

9

Replication Queue Reader Agent.

SQLDMOReplAgent_Snapshot

1

Replication Snapshot Agent.

備註

Changing a replication agent profile setting by using the UpdateAgentProfile method requires appropriate permission. The SQL Server login used for SQLServer object connection must be a member of the fixed role sysadmin.

Applies To:

Distributor Object