PullSubscription.AgentOffloadServer Property

Article
12/03/2008

Gets or sets the name of the remote computer where the agent runs when using remote agent activation.

Namespace: Microsoft.SqlServer.Replication
Assembly: Microsoft.SqlServer.Rmo (in microsoft.sqlserver.rmo.dll)

Syntax

'Declaration
Public Property AgentOffloadServer As String

public string AgentOffloadServer { get; set; }

public:
property String^ AgentOffloadServer {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_AgentOffloadServer ()

/** @property */
public void set_AgentOffloadServer (String value)

public function get AgentOffloadServer () : String

public function set AgentOffloadServer (value : String)

Property Value

A String value.

Remarks

Microsoft SQL Server 2000 supported running the Distribution Agent or Merge Agent on another computer and then activating that agent remotely using Distributed Component Object Model (DCOM). Support has been discontinued for Distributors running SQL Server 2005 and later; it has been deprecated for Distributors running earlier versions of SQL Server. Setting the AgentOffloadServer property on an instance of SQL Server 2005 will generate an exception on the server.

The AgentOffloadServer property can only be retrieved by members of the sysadmin fixed server role at the Subscriber or by members of the db_owner fixed database role on the subscription database.

The AgentOffloadServer property can only be set by members of the sysadmin fixed server role at the Subscriber or by members of the db_owner fixed database role on the subscription database.

Retrieving the AgentOffloadServer property is equivalent to executing sp_helppullsubscription (Transact-SQL) or sp_helpmergepullsubscription (Transact-SQL).

Setting the AgentOffloadServer property is equivalent to executing sp_enableagentoffload (Transact-SQL), sp_disableagentoffload (Transact-SQL), sp_addpullsubscription_agent (Transact-SQL), or sp_addmergepullsubscription_agent (Transact-SQL).

The AgentOffloadServer property is available with SQL Server 2000.

This namespace, class, or member is supported only in version 2.0 of the .NET Framework.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Share via