Método AddSubscription (Replicación)
Las aplicaciones llaman al método AddSubscription para crear una nueva suscripción anónima a una publicación existente de Microsoft SQL Server. Después de llamar al método AddSubscription, la aplicación debe llamar al método Synchronize para sincronizar la nueva suscripción con la publicación.
Sintaxis
object.AddSubscription(DBADDOPTION)
Se aplica a
Objeto Replication de SQL Server Compact 3.5 (SQL Server Compact 3.5)
Parámetros genéricos
| Parámetro | Descripción |
|---|---|
DBADDOPTION |
Especifica cómo crear la nueva suscripción. |
Parámetro DBADDOPTION
El parámetro DBADDOPTION especifica cómo crear la nueva suscripción. Este parámetro determina si debe crearse una nueva base de datos de SQL Server Compact 3.5 o debe usarse una base de datos existente, de acuerdo con los valores de configuración de la siguiente tabla:
| Constante | Valor | Descripción |
|---|---|---|
EXISTING_DATABASE |
0 |
Asume que la base de datos de SQL Server Compact 3.5 ya está creada. |
CREATE_DATABASE |
1 |
Provoca la creación de la base de datos de SQL Server Compact 3.5 en el dispositivo (valor predeterminado). |
El valor EXISTING_DATABASE de DBADDOPTION especifica que la base de datos ya existe pero es necesario obtener el contenido del publicador. En este caso, los métodos AddSubscription y Synchronize crean la suscripción de SQL Server Compact 3.5 y, a continuación, descargan el contenido de la base de datos desde el publicador de SQL Server.
Puesto que una sola base de datos de SQL Server Compact 3.5 puede suscribirse a varias publicaciones, hay que tener especial cuidado al usar el valor EXISTING_DATABASE. Si la base de datos ya existe y desea agregar una suscripción adicional, deberá especificar las propiedades Publisher, Publication y PublisherDatabase antes de llamar al método AddSubscription.
El valor CREATE_DATABASE de DBADDOPTION especifica que debe crearse primero la base de datos de SQL Server Compact 3.5 y, a continuación, obtener el contenido de la suscripción del publicador. En este caso, los métodos AddSubscription y Synchronize crean la base de datos y la suscripción de SQL Server Compact 3.5 y, a continuación, descargan el contenido de la base de datos desde el publicador de SQL Server.
Prototipo
HRESULT AddSubscription(DBADDOPTION DBAddOption);
Devuelve
| Código de retorno | Descripción |
|---|---|
S_OK |
Método finalizado correctamente. |
Cualquier FAILED(HRESULT) |
Compruebe la colección SSCEErrors para obtener información detallada sobre los errores. |
Notas
Para que una aplicación de SQL Server Compact 3.5 pueda suscribirse a una publicación y replicar datos, el administrador de la base de datos debe configurar primero SQL Server para que sea compatible con la replicación de mezcla y crear una publicación de SQL Server que esté habilitada para suscripciones de SQL Server Compact 3.5.
Vea también
Referencia
Propiedad Publicador (Replicación)
Propiedad Publicación (Replicación)
Propiedad PublisherDatabase (Replicación)
Otros recursos
Métodos del objeto Replication