Synchronize, méthode (RDS)
Synchronisez l’objet Recordset donné avec la base de données spécifiée par la chaîne de connexion pour une utilisation dans ADO 2.5 et versions ultérieures.
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.Synchronize(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray, [lcid As Long], [pInformation)
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é, il 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 du gestionnaire. Les deux parties sont séparées par la première instance d’une virgule dans la chaîne (bien que la chaîne d’arguments puisse 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 (push) à 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 Aucune ligne contenant des modifications en attente n’est mise à 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 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.
lcid
LCID utilisé pour générer toutes les erreurs retournées dans pInformation.
pInformation
Pointeur vers une erreur d’information retournée par la méthode Execute. Si la valeur est NULL, aucune information d’erreur n’est retournée.
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 alors l’argument comme une instruction d’utiliser le fichier sample.ini pour vérifier les chaînes de connexion et de requête.