Método Synchronize21 (RDS)

Sincroniza el conjunto de registros especificado con la base de datos especificada por la cadena de conexión para su uso con ADO 2.1.

Importante

A partir de Windows 8 y Windows Server 2012, los componentes del servidor RDS ya no se incluyen en el sistema operativo Windows (para obtener más información, consulte Windows 8 y la Guía de compatibilidad de Windows Server 2012, edición Cookbook). Los componentes de cliente de RDS se eliminarán en una versión futura de Windows. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. Las aplicaciones que usan RDS deben migrar al servicio de datos WCF.

Sintaxis

  
object.Synchronize21(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray)  

Parámetros

ConnectionString
Cadena usada para conectarse al proveedor OLE DB donde se enviará la solicitud. Si se usa un controlador, el controlador puede editar o reemplazar la cadena de conexión.

HandlerString
La cadena identifica el controlador que se va a usar con esta ejecución. La cadena contiene dos partes. La primera parte contiene el nombre (ProgID) del controlador que se va a usar. La segunda parte de la cadena contiene argumentos que se van a pasar al controlador. Cómo se interpreta la cadena de argumentos es específico del controlador. Las dos partes están separadas por la primera instancia de una coma en la cadena. La cadena de argumentos puede contener comas adicionales. Los argumentos son opcionales.

lSynchronizeOptions
Máscara de bits de opciones de sincronización.

1=UpdateTransact Las actualizaciones a la base de datos se encapsulan en una transacción. La transacción se anula si se produce un error en alguna de las actualizaciones.

2=RefreshWithUpdate Hace que se devuelvan los estados de fila cuando no se establece Refresh ni RefreshConflicts.

4=Actualizar El conjunto de registros se actualiza con los datos actuales de la base de datos. Las actualizaciones pendientes no se insertan en la base de datos. Si no se establece este bit, el conjunto de registros no se actualiza y las actualizaciones pendientes se insertan en la base de datos.

8=RefreshConflicts Las filas con cambios pendientes no se pueden actualizar. Las filas que no se pudieron actualizar se actualizan con los datos actuales de la base de datos.

ppRecordset
Puntero a un puntero al conjunto de registros que se va a sincronizar.

pStatusArray
Variante usada para devolver una matriz segura de estados de fila para las filas afectadas por la sincronización. No se establece si no se establece ninguna de las siguientes opciones de sincronización: RefreshWithUpdate, Refresh y RefreshConflicts.

Comentarios

El parámetro HandlerString puede ser null. Lo que sucede en este caso depende de cómo se configura el servidor RDS. Una cadena de controlador de "MSDFMAP.handler" indica que se debe usar el controlador proporcionado por Microsoft (Msdfmap.dll). Una cadena de controlador de "MASDFMAP.handler,sample.ini" indica que se debe usar el controlador de Msdfmap.dll y que el argumento "sample.ini" debe pasarse al controlador. Msdfmap.dll interpretará el argumento como una dirección para usar el sample.ini para comprobar las cadenas de conexión y consulta.

Nota

El método Synchronize21 es simplemente una versión del método Synchronize (RDS). Cuando necesite usar el método Synchronize para comunicarse con ADO 2.1, se puede llamar al método Synchronize21 en su lugar. Las funcionalidades del método Synchronize en ADO 2.5 y versiones posteriores son un superconjunto de las funcionalidades proporcionadas para el mismo método en ADO 2.1.

Se aplica a

Objeto DataFactory (RDSServer)