AddSubscription メソッド (レプリケーション ActiveX)

AddSubscription メソッドは、指定したコントロールのプロパティに基づいて、新しいサブスクリプションまたは既存のサブスクリプションを追加します。

構文

object.AddSubscription DBAddOption, SubscriptionHost

要素	説明
object	結果が「適用対象」の一覧に含まれるオブジェクトになる式。
DBAddOption	追加するオプション。DBADDOPTION (レプリケーション ActiveX) の値を使用します。
SubscriptionHost	サブスクリプションホスト。SUBSCRIPTION_HOST (レプリケーション ActiveX) の値を使用します。

リターンコード	説明
S_OK	メソッドは成功しました。
E_FAIL	一般エラーが発生しました。詳細については、エラーレコードを確認してください。
REPLX_E_DBEXISTS	指定したデータベースが既に存在します。
REPLX_E_DBNOTFOUND	指定したデータベースが存在しません。
REPLX_E_SUBEXISTS	指定したサブスクリプションが既に存在します。
REPLX_E_RETRYFAILURE	エラーが発生しました。最後の操作の再試行が必要な可能性があります。

プッシュサブスクリプションは現在このメソッドでサポートされていません。

Initialize メソッド (レプリケーション ActiveX) を AddSubscription の使用前に呼び出すことは避けてください。

DBAddOption を ATTACH_DATABASE に設定し、SubscriberDatasourceType プロパティ (レプリケーション ActiveX) を SQL_SERVER に設定した場合、AddSubscription は単一ファイルのデータベースでのみ使用できます。SubscriberDatabasePath プロパティ (レプリケーション ActiveX) プロパティを使用して、アタッチする .mdf ファイルの名前とパスを指定します。

DBAddOption が ATTACH_SUBSCRIPTION である場合は、SubscriberDatabasePath プロパティ (レプリケーション ActiveX) を使用して .msf (Microsoft Subscription File) の名前とパスを指定します。このファイルは、CopySubscription メソッド (レプリケーション ActiveX) メソッドで作成できます。

AddSubscription は、新しいサブスクライバデータベースの作成もサポートします。既存のデータベースに対して新しいサブスクリプションを作成し、既存のサブスクリプションを Windows 同期マネージャに登録します。

Microsoft Visual Basic では、AddSubscription は Sub メソッドであり、値を返しません。

HRESULT AddSubscription(
     DBADDOPTION DBAddOption,
     SUBSCRIPTION_HOST SubscriptionHost);