Метод Synchronize21 (RDS)
Синхронизируйте заданный набор записей с базой данных, указанной строкой подключения для использования с ADO 2.1.
Важный
Начиная с Windows 8 и Windows Server 2012, компоненты сервера RDS больше не включены в операционную систему Windows (дополнительные сведения см. в статье Windows 8 и Windows Server 2012 Compatibility Cookbook). Клиентские компоненты RDS будут удалены в будущей версии Windows. Избегайте использования этой функции в новой работе разработки и планируйте изменение приложений, которые в настоящее время используют эту функцию. Приложения, использующие RDS, должны перенестися в службы данных WCF.
Синтаксис
object.Synchronize21(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray)
Параметры
ConnectionString
Строка, используемая для подключения к поставщику OLE DB, в котором будет отправлен запрос. Если используется обработчик, обработчик может изменить или заменить строку подключения.
HandlerString
Строка определяет обработчик, используемый с этим выполнением. Строка содержит две части. Первая часть содержит имя (ProgID) используемого обработчика. Вторая часть строки содержит аргументы, передаваемые обработчику. Как интерпретируется строка аргументов, определяется обработчиком. Две части разделяются первым экземпляром запятой в строке. Строка аргументов может содержать дополнительные запятые. Аргументы являются необязательными.
lSynchronizeOptions
Битовая маска параметров синхронизации.
1=UpdateTransact Обновления базы данных упаковываются в транзакцию. Транзакция прерывается, если какой-либо из обновлений завершается ошибкой.
2=RefreshWithUpdate приводит к возврату состояний строк, если Обновить или RefreshConflicts.
4=Обновить Набор записей обновляется с текущими данными из базы данных. Ожидающие обновления не отправляются в базу данных. Если этот бит не задан, набор записей не обновляется, а ожидающие обновления отправляются в базу данных.
8=RefreshConflicts Любые строки с ожидающих изменений не удалось обновить. Строки, которые не удалось обновить, обновляются с текущими данными из базы данных.
ppRecordset
Указатель на указатель на набор записей для синхронизации.
pStatusArray
Вариант, используемый для возврата безопасного массива состояний строк для строк, затронутых синхронизацией. Не задано, если ни один из следующих параметров синхронизации не задан: RefreshWithUpdate, Refresh и RefreshConflicts.
Замечания
Параметр HandlerString может иметь значение NULL. Что происходит в этом случае, зависит от того, как настроен сервер RDS. Строка обработчика MSDFMAP.handler указывает, что следует использовать предоставленный корпорацией Майкрософт обработчик (Msdfmap.dll). Строка обработчика "MASDFMAP.handler,sample.ini" указывает, что обработчик Msdfmap.dll должен использоваться и что аргумент "sample.ini" должен передаваться обработчику. Msdfmap.dll затем интерпретирует аргумент в качестве направления, чтобы использовать sample.ini для проверки строк подключения и запроса.
Заметка
Метод Synchronize21 — это просто версия метода синхронизации(RDS). Где необходимо использовать метод синхронизации синхронизации для взаимодействия с ADO 2.1, вместо этого можно вызвать метод Synchronize21. Возможности метода синхронизации синхронизации в ADO 2.5 и более поздних версий являются супермножеством возможностей, предоставляемых для того же метода в ADO 2.1.