Metodo Synchronize21 (RDS)
Sincronizzare il recordset specificato con il database specificato dalla stringa di connessione da usare con ADO 2.1.
Importante
A partire da Windows 8 e Windows Server 2012, i componenti del server Servizi Desktop remoto non sono più inclusi nel sistema operativo Windows (vedere Windows 8 e Guida di riferimento per la compatibilità di Windows Server 2012 per altri dettagli). I componenti client di Servizi Desktop remoto verranno rimossi in una versione futura di Windows. Evitare di usare questa funzionalità nel nuovo lavoro di sviluppo e pianificare la modifica delle applicazioni che attualmente usano questa funzionalità. Le applicazioni che usano Servizi Desktop remoto devono eseguire la migrazione a WCF Data Service.
Sintassi
object.Synchronize21(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray)
Parametri
ConnectionString
Stringa utilizzata per connettersi al provider OLE DB in cui verrà inviata la richiesta. Se viene usato un gestore, il gestore può modificare o sostituire la stringa di connessione.
HandlerString
La stringa identifica il gestore da usare con questa esecuzione. La stringa contiene due parti. La prima parte contiene il nome (ProgID) del gestore da usare. La seconda parte della stringa contiene argomenti da passare al gestore. La modalità di interpretazione della stringa degli argomenti è specifica del gestore. Le due parti sono separate dalla prima istanza di una virgola nella stringa. La stringa degli argomenti può contenere virgole aggiuntive. Gli argomenti sono facoltativi.
lSynchronizeOptions
Maschera di bit delle opzioni di sincronizzazione.
1=UpdateTransact Gli aggiornamenti del database vengono inclusi in una transazione. La transazione viene interrotta se uno degli aggiornamenti ha esito negativo.
2=RefreshWithUpdate Determina la restituzione degli stati delle righe quando non vengono impostati né Aggiorna né RefreshConflicts.
4=Aggiorna Il recordset viene aggiornato con i dati correnti dal database. Gli aggiornamenti in sospeso non vengono inseriti nel database. Se questo bit non è impostato, il recordset non viene aggiornato ed eventuali aggiornamenti in sospeso vengono inseriti nel database.
8=RefreshConflicts Le righe con modifiche in sospeso non vengono aggiornate. Le righe che non è stato possibile aggiornare vengono aggiornate con i dati correnti del database.
ppRecordset
Puntatore a un puntatore al recordset da sincronizzare.
pStatusArray
Variante utilizzata per restituire una matrice sicura di stati di riga per le righe interessate dalla sincronizzazione. Non impostato se non sono impostate le opzioni di sincronizzazione seguenti: RefreshWithUpdate, Aggiorna e RefreshConflicts.
Osservazioni
Il parametro HandlerString può essere Null. Ciò che accade in questo caso dipende dalla configurazione del server Servizi Desktop remoto. Una stringa del gestore "MSDFMAP.handler" indica che deve essere usato il gestore fornito da Microsoft (Msdfmap.dll). Una stringa del gestore "MASDFMAP.handler,sample.ini" indica che il gestore Msdfmap.dll deve essere usato e che l'argomento "sample.ini" deve essere passato al gestore. Msdfmap.dll interpreterà quindi l'argomento come direzione per usare il sample.ini per controllare le stringhe di connessione e di query.
Nota
Il metodo Synchronize21 è semplicemente una versione del metodo Synchronize (RDS). Dove è necessario utilizzare il metodo Synchronize per comunicare con ADO 2.1, è possibile chiamare il metodo Synchronize21. Le funzionalità del metodo Synchronize in ADO 2.5 e versioni successive sono un superset delle funzionalità fornite per lo stesso metodo in ADO 2.1.