Metodo Synchronize (Servizi Desktop remoto)

Sincronizzare il Recordset specificato con il database specificato dalla stringa di connessione per l'utilizzo in ADO 2.5 e versioni successive.

Importante

A partire da Windows 8 e Windows Server 2012, i componenti del server di RDS non sono più inclusi nel sistema operativo Windows. Per altri dettagli, vedere la Guida di riferimento per la compatibilità di Windows 8 e Windows Server 2012. I componenti del client di RDS verranno rimossi in una versione futura di Windows. Evitare di usare questa funzionalità in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata. Le applicazioni che usano RDS devono eseguire la migrazione a WCF Data Service.

Sintassi

  
object.Synchronize(ConnectionString As String, HandlerString As String, lSynchronizeOptions As Long, ppRecordset As Object, pStatusArray, [lcid As Long], [pInformation)  

Parametri

ConnectionString
Una stringa usata per connettersi al provider OLE DB in cui verrà inviata la richiesta. Se viene usato un gestore, può modificare o sostituire la stringa di connessione.

HandlerString
La stringa identifica il gestore da usare con questa esecuzione. La stringa è costituita da due parti: la prima parte contiene il nome (ProgID) del gestore da usare e la seconda parte della stringa contiene gli argomenti da passare al gestore. La modalità di interpretazione della stringa di argomenti è specifica del gestore. Le due parti sono separate in prima istanza di una virgola nella stringa, sebbene la stringa degli argomenti possa contenere più virgole. Gli argomenti sono facoltativi.

lSynchronizeOptions
Maschera di bit delle opzioni di sincronizzazione.

1=UpdateTransact Gli aggiornamenti al database vengono sottoposti a wrapping in una transazione. La transazione viene interrotta se uno degli aggiornamenti ha esito negativo.

2=RefreshWithUpdate Causa la restituzione dello stato delle righe quando non vengono impostati né RefreshRefreshConflicts.

4=Refresh Il recordset viene aggiornato con i dati correnti dal database. Non viene eseguito il push degli aggiornamenti in sospeso al database. Se questo bit non è impostato, il recordset non viene aggiornato e viene eseguito il push degli aggiornamenti in sospeso al database.

8=RefreshConflicts Le righe con modifiche in sospeso non possono eseguire l'aggiornamento. Le righe che non sono hanno eseguito l'aggiornamento vengono aggiornate con i dati correnti dal database.

ppRecordset
Puntatore al recordset da sincronizzare.

pStatusArray
Variante usata per restituire una matrice sicura di stati di riga per le righe interessate dalla sincronizzazione. Non impostata se non sono impostate le opzioni di sincronizzazione seguenti: RefreshWithUpdate, Refresh e RefreshConflicts.

lcid
LCID usato per compilare eventuali errori restituiti in pInformation.

pInformation
Puntatore a informazioni sull'errore restituite da Execute. Se NULL, non vengono restituite informazioni sull'errore.

Osservazioni

Il valore del parametro HandlerString può essere null. Ciò che accade in questo caso dipende dalla configurazione del server RDS. La stringa del gestore "MSDFMAP.handler" indica che è necessario usare il gestore fornito da Microsoft (Msdfmap.dll). La stringa del gestore "MASDFMAP.handler,sample.ini" indica che è necessario usare il gestore Msdfmap.dll e passare l'argomento "sample.ini" al gestore. Msdfmap.dll interpreterà l'argomento come un'istruzione di usare l'argomento sample.ini e di controllare le stringhe di connessione e di query.

Si applica a

Oggetto DataFactory (RDSServer)