ReplicationDatabase.LinkPublicationForUpdateableSubscription Method

Reference

Definition

Namespace:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Sets the configuration and security information used by synchronization triggers of updatable subscriptions when connecting to the Publisher.

public:
 void LinkPublicationForUpdateableSubscription(System::String ^ publisher, System::String ^ publisherDB, System::String ^ publication, System::String ^ distributor, Microsoft::SqlServer::Replication::PublisherConnectionSecurityContext ^ publisherSecurity);

public void LinkPublicationForUpdateableSubscription (string publisher, string publisherDB, string publication, string distributor, Microsoft.SqlServer.Replication.PublisherConnectionSecurityContext publisherSecurity);

member this.LinkPublicationForUpdateableSubscription : string * string * string * string * Microsoft.SqlServer.Replication.PublisherConnectionSecurityContext -> unit

Public Sub LinkPublicationForUpdateableSubscription (publisher As String, publisherDB As String, publication As String, distributor As String, publisherSecurity As PublisherConnectionSecurityContext)

Parameters

publisher: String

The name of the Publisher to which the updating Subscriber connects.

publisherDB: String

The name of the publication database.

publication: String

The name of the publication.

distributor: String

The name of the Distributor used by this updating Subscriber.

publisherSecurity: PublisherConnectionSecurityContext

A PublisherConnectionSecurityContext value that defines how the updating Subscriber connects to the Publisher.

Exceptions

ApplicationException

When the version is not Microsoft SQL Server 2005 or later.

ArgumentException

When one of the String string parameters is null, contains null characters, or is longer than 128 Unicode characters.

Remarks

The LinkPublicationForUpdateableSubscription method can be called for both push and pull subscription databases. It can be called before or after the subscription is created.

The LinkPublicationForUpdateableSubscription method must only be called when the currently connected instance of SQL Server is an updatable Subscriber to a transactional publication.

The default mode used by an immediate updating Subscriber when it connects to the Publisher does not allow a connection using Windows Authentication. To connect with a mode of Windows Authentication, a linked server will have to be set up to the Publisher, and the immediate updating Subscriber should use this connection when updating the Subscriber. This requires that you specify a value of Integrated for the PublisherConnectionSecurityContext passed in the PublisherSecurity parameter when calling LinkPublicationForUpdateableSubscription.

The LinkPublicationForUpdateableSubscription method can only be called by a member of the sysadmin fixed server role at the Subscriber.

Calling LinkPublicationForUpdateableSubscription is equivalent to executing sp_link_publication (Transact-SQL).

Applies to