Método Synchronize21 (RDS)

Sincronize o conjunto de registros especificado com o banco de dados especificado pela cadeia de conexão para uso com o ADO 2.1.

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 (confira Windows 8 e Manual de Compatibilidade do Windows Server 2012 para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Os aplicativos que usam o RDS devem migrar para o Serviço de Dados do WCF.

Sintaxe

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

Parâmetros

ConnectionString
Uma cadeia de caracteres usada para se conectar ao provedor OLE DB para o qual a solicitação será enviada. Se um manipulador for usado, ele 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 os argumentos a serem transmitidos 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. A cadeia de caracteres de argumentos pode conter vírgulas adicionais. Os argumentos são opcionais.

lSynchronizeOptions
Um bitmask das opções de sincronização.

1=UpdateTransact As atualizações no 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 Refresh nem RefreshConflicts estiverem definidos.

4=Refresh 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 ao banco de dados.

8=RefreshConflicts Todas as linhas com as 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 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.

Comentários

O parâmetro HandlerString pode ser nulo. O que acontece nesse caso depende de como o servidor RDS está 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 transmitido para o manipulador. Em seguida, a Msdfmap.dll interpretará o argumento como uma instrução para usar o sample.ini a fim de verificar as cadeias de conexão e de consulta.

Observação

O método Synchronize21 é simplesmente uma versão do método Synchronize (RDS). Quando você precisa usar o método Synchronize para se comunicar com o ADO 2.1, o método Synchronize21 pode ser chamado no lugar dele. As funcionalidades do método Synchronize no ADO 2.5 e posterior são um superconjunto das funcionalidades fornecidas para o mesmo método no ADO 2.1.

Aplica-se A

Objeto DataFactory (RDSServer)