Synchronize21, méthode (RDS)
Synchronise le recordset donné avec la base de données spécifiée par la chaîne de connexion pour une utilisation 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 le Guide pratique sur la compatibilité de Windows Server 2012 et Windows 8 pour plus de détails). Les composants clients RDS seront supprimés dans une version ultérieure de Windows. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux 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
Chaîne identifiant 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 à transmettre 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 Les mises à jour à 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 Entraîne le retour des états de ligne quand aucun des arguments Refresh et RefreshConflicts n’est défini.
4=Refresh Le Recordset est actualisé avec les données actives 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 recordset 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 sont pas 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 Recordset à synchroniser.
pStatusArray
Variant 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, Refresh et RefreshConflicts.
Notes
Le paramètre HandlerString peut être null. Ce qui se passe dans ce cas dépend de la façon dont le serveur RDS est configuré. Une chaîne de gestionnaire « 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 transmis au gestionnaire. Msdfmap.dll interprétera ensuite l’argument comme une direction pour utiliser le sample.ini pour vérifier les chaînes de connexion et de requête.
Remarque
La méthode Synchronize21 est simplement une version de la méthode Synchrone (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 Synchrone 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.