Share via


ReplicationDatabase.LinkPublicationForUpdateableSubscription Method

Definition

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

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

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