ReplicationDatabase.LinkPublicationForUpdateableSubscription Method

Article
12/03/2008

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

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

Syntax

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

public void LinkPublicationForUpdateableSubscription (
    string publisher,
    string publisherDB,
    string publication,
    string distributor,
    PublisherConnectionSecurityContext publisherSecurity
)

public:
void LinkPublicationForUpdateableSubscription (
    String^ publisher, 
    String^ publisherDB, 
    String^ publication, 
    String^ distributor, 
    PublisherConnectionSecurityContext^ publisherSecurity
)

public void LinkPublicationForUpdateableSubscription (
    String publisher, 
    String publisherDB, 
    String publication, 
    String distributor, 
    PublisherConnectionSecurityContext publisherSecurity
)

public function LinkPublicationForUpdateableSubscription (
    publisher : String, 
    publisherDB : String, 
    publication : String, 
    distributor : String, 
    publisherSecurity : PublisherConnectionSecurityContext
)

Parameters

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

publisherDB
The name of the publication database.

publication
The name of the publication.

distributor
The name of the Distributor used by this updating Subscriber.

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

Exceptions

Exception type	Condition
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).

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