Synchronize21, méthode (RDS)
Synchronisez le jeu d’enregistrements donné avec la base de données spécifiée par la chaîne de connexion à utiliser avec ADO 2.1.
Important
À compter de Windows 8 et Windows Server 2012, les composants serveur RDS ne sont plus inclus dans le système d’exploitation Windows (voir Windows 8 et livre de recettes de compatibilité Windows Server 2012 pour plus de détails). Les composants clients RDS seront supprimés dans une prochaine version de Windows. Évitez d’utiliser cette fonctionnalité dans le nouveau travail de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Les applications qui utilisent RDS doivent migrer vers wcf Data Service .
Syntaxe
object.Synchronize21(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray)
Paramètres
connectionString
Chaîne utilisée pour se connecter au fournisseur OLE DB où la requête sera envoyée. Si un gestionnaire est utilisé, le gestionnaire peut modifier ou remplacer la chaîne de connexion.
HandlerString
La chaîne identifie le gestionnaire à utiliser avec cette exécution. La chaîne contient deux parties. La première partie contient le nom (ProgID) du gestionnaire à utiliser. La deuxième partie de la chaîne contient des arguments à passer au gestionnaire. La façon dont la chaîne d’arguments est interprétée est spécifique au gestionnaire. Les deux parties sont séparées par la première instance d’une virgule dans la chaîne. La chaîne d’arguments peut contenir des virgules supplémentaires. Les arguments sont facultatifs.
lSynchronizeOptions
Masque de bits des options de synchronisation.
1=UpdateTransact Mises à jour de la base de données sont encapsulées dans une transaction. La transaction est abandonnée si l’une des mises à jour échoue.
2=RefreshWithUpdate Provoque le retour des états de ligne lorsque ni Actualiser ni RefreshConflicts est défini.
4=Actualiser Le jeu d’enregistrements est actualisé avec les données actuelles de la base de données. Les mises à jour en attente ne sont pas envoyées à la base de données. Si ce bit n’est pas défini, le jeu d’enregistrements n’est pas actualisé et les mises à jour en attente sont envoyées à la base de données.
8=RefreshConflicts Toutes les lignes avec des modifications en attente ne parviennent pas à être mises à jour. Les lignes qui n’ont pas pu être mises à jour sont actualisées avec les données actuelles de la base de données.
ppRecordset
Pointeur vers un pointeur vers le jeu d’enregistrements à synchroniser.
pStatusArray
Variante utilisée pour retourner un tableau sécurisé d’états de ligne pour les lignes affectées par la synchronisation. Non défini si aucune des options de synchronisation suivantes n’est définie : RefreshWithUpdate, Actualiser et RefreshConflicts.
Remarques
Le paramètre HandlerString peut être null. Ce qui se passe dans ce cas dépend de la configuration du serveur RDS. Une chaîne de gestionnaire de « MSDFMAP.handler » indique que le gestionnaire fourni par Microsoft (Msdfmap.dll) doit être utilisé. Une chaîne de gestionnaire « MASDFMAP.handler,sample.ini» indique que le gestionnaire Msdfmap.dll doit être utilisé et que l’argument «sample.ini» doit être passé au gestionnaire. Msdfmap.dll interprétera ensuite l’argument comme une direction pour utiliser les sample.ini pour vérifier la connexion et les chaînes de requête.
Note
La méthode Synchronize21 est simplement une version de la méthode Synchronize (RDS). Lorsque vous devez utiliser la méthode Synchronize pour communiquer avec ADO 2.1, la méthode Synchronize21 peut être appelée à la place. Les fonctionnalités de la méthode Synchronize dans ADO 2.5 et ultérieures sont un super-ensemble des fonctionnalités fournies pour la même méthode dans ADO 2.1.