Share via


AttachSubscriptionDatabase Method

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The AttachSubscriptionDatabase method attaches a copied subscription database to a Subscriber.

Syntax

object
.AttachSubscriptionDatabase(
szDatabaseName 
,
szFilename 
,
SubscriberSecurityType 
,
szSubscriberLogin 
,
szSubscriberPassword 
)

Parts

  • object
    Expression that evaluates to an object in the Applies To list.

  • szDatabaseName
    String that specifies the database to attach.

  • szFilename
    String that specifies the complete path and file name from which to attach the database.

  • SubscriberSecurityType
    Long integer that specifies the type of security used at the Subscriber.

  • szSubscriberLogin
    String that specifies the Subscriber login.

  • szSubscriberPassword
    String that specifies the Subscriber password.

Prototype (C/C++)

HRESULT AttachSubscriptionDatabase(
SQLDMO_LPCSTR pszDatabaseName,
SQLDMO_LPCSTR pszFileName, 
SQLDMO_SECURITY_TYPE SubscriberSecurityType, 
SQLDMO_LPCSTR pszSubscriberLogin, 
SQLDMO_LPCSTR pszSubscriberPassword);

Settings

Set SubscriberSecurityType by using these SQLDMO_SECURITY_TYPE values.

Constant

Value

Description

SQLDMOSecurity_Integrated

1

Allow Windows Authentication only.

SQLDMOSecurity_Mixed

2

Allow Windows Authentication or SQL Server Authentication.

SQLDMOSecurity_Normal

0

Allow SQL Server Authentication only.

SQLDMOSecurity_Unknown

9

Security type unknown.

Remarks

After using the CopySubscriptionDatabase method to copy a subscription database to a Subscriber, you must use AttachSubscriptionDatabase to attach the database at the Subscriber.

Note

If an application calls AttachSubscriptionDatabase on an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000" are returned.

Applies to: