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