Método Synchronize (RDS)
Sincronize o Conjunto de Registros especificado com o banco de dados especificado pela cadeia de conexão para uso no ADO 2.5 e posterior.
Importante
A partir do Windows 8 e do Windows Server 2012, os componentes do servidor RDS não estão mais incluídos no sistema operacional Windows (consulte o Windows 8 e o Windows Server 2012 Compatibility Cookbook para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Os aplicativos que usam RDS devem migrar para WCF Data Service.
Sintaxe
object.Synchronize(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray, [lcid As Long], [pInformation)
Parâmetros
ConnectionString
Uma cadeia de caracteres usada para se conectar ao provedor OLE DB para onde a solicitação será enviada. Se um manipulador for usado, o manipulador poderá editar ou substituir a cadeia de conexão.
HandlerString
A cadeia de caracteres identifica o manipulador a ser usado com essa execução. A cadeia de caracteres contém duas partes. A primeira parte contém o nome (ProgID) do manipulador a ser usado. A segunda parte da cadeia de caracteres contém argumentos a serem passados para o manipulador. A forma como a cadeia de caracteres de argumentos é interpretada é específica do manipulador. As duas partes são separadas pela primeira instância de uma vírgula na cadeia de caracteres (embora a cadeia de caracteres de argumentos possa conter vírgulas adicionais). Os argumentos são opcionais.
lSynchronizeOptions
Uma máscara de bits de opções de sincronização.
1=UpdateTransact Atualizações para o banco de dados são encapsuladas em uma transação. A transação será anulada se alguma das atualizações falhar.
2=RefreshWithUpdate Faz com que os status das linhas sejam retornados quando nem de Atualização nem RefreshConflicts estiver definido.
4=Atualizar O conjunto de registros é atualizado com os dados atuais do banco de dados. As atualizações pendentes não são enviadas por push para o banco de dados. Se esse bit não estiver definido, o conjunto de registros não será atualizado e todas as atualizações pendentes serão enviadas por push para o banco de dados.
8=RefreshConflicts Todas as linhas com alterações pendentes não são atualizadas. As linhas que não foram atualizadas são atualizadas com os dados atuais do banco de dados.
ppRecordset
Um ponteiro para o conjunto de registros a ser sincronizado.
pStatusArray
Uma variante usada para retornar uma matriz segura de status de linha para as linhas afetadas pela sincronização. Não definido se nenhuma das seguintes opções de sincronização estiver definida: RefreshWithUpdate, Refresh e RefreshConflicts.
lcid
O LCID usado para criar erros retornados em pInformation.
pInformation
Um ponteiro para o erro de informações retornado por Executar. Se NULL, nenhuma informação de erro será retornada.
Observações
O parâmetro HandlerString pode ser nulo. O que acontece nesse caso depende de como o servidor RDS é configurado. Uma cadeia de caracteres de manipulador de "MSDFMAP.handler" indica que o manipulador fornecido pela Microsoft (Msdfmap.dll) deve ser usado. Uma cadeia de caracteres de manipulador de "MASDFMAP.handler,sample.ini" indica que o manipulador de Msdfmap.dll deve ser usado e que o argumento "sample.ini" deve ser passado para o manipulador. Msdfmap.dll interpretará o argumento como uma direção para usar o sample.ini para verificar as cadeias de conexão e consulta.