Metodo Execute21 (Servizi Desktop remoto)
Esegue la richiesta e crea un recordset ADO da usare in ADO 2.1.
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.Execute21(ConnectionString As String, HandlerString As String, QueryString As String, lMarshalOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters)
Parametri
ConnectionString
Una stringa usata per connettersi al provider OLE DB in cui verrà inviata la richiesta per l'esecuzione. Se un gestore viene specificato usando HandlerString, 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.
QueryString
Un comando nel linguaggio di comando supportato dal provider OLE DB identificato nella stringa di connessione. Per i provider basati su SQL potrebbe contenere un'istruzione di comando Transact-SQL, ma per i provider non SQL, ad esempio MSDataShape, potrebbe non trattarsi di un'istruzione di query Transact-SQL.
Inoltre, se si usa un gestore (operazione consigliata), questo può modificare o sostituire il valore specificato qui. Ad esempio, il gestore sostituisce in genere QueryString con una stringa di query dal file .ini. Per impostazione predefinita, viene usato il file Msdfmap.ini.
lMarshalOptions
Usato per impostare le opzioni di marshalling sul set di righe/recordset restituito.
TableID
Una variante di tipo VT_EMPTY o VT_BSTR. Se questo valore è di tipo VT_EMPTY, viene ignorato. Se è di tipo VT_BSTR, il recordset viene creato usando adCmdTableDirect e il valore specificato qui, ignorando così il parametro QueryString.
lExecuteOptions
Una maschera di bit delle opzioni di esecuzione:
1=ReadOnly. Il recordset verrà aperto usando adLockReadOnly.
2=NoBatch. Il recordset verrà aperto usando adLockOptimistic.
4=AllParamInfoSupplied. Il chiamante garantisce che le informazioni relative a tutti i parametri vengano fornite in pParameters.
8=GetInfo. Le informazioni sui parametri per la query verranno ottenute dal provider OLE DB e restituite nel parametro pParameters. La query non viene eseguita e non viene restituito alcun recordset.
16=GetHiddenColumns. Il recordset verrà aperto usando adLockBatchOptimistic e tutte le colonne nascoste verranno incluse nel recordset.
Sebbene le opzioni ReadOnly, NoBatch e GetHiddenColumns si escludano a vicenda, è possibile impostarne più di una. Se si impostano più opzioni, GetHiddenColumns ha la precedenza su tutte le altre, seguita da ReadOnly. Se non viene specificata alcuna opzione, per impostazione predefinita il recordset viene aperto usando adLockBatchOptimistic ma le colonne nascoste non sono incluse al suo interno.
pParameters
Una variante che contiene una matrice protetta di definizioni di parametri. Se l'opzione GetInfo è stata specificata in lExecuteOptions, questo parametro viene usato per restituire le definizioni dei parametri ottenute dal provider OLE DB. In caso contrario, questo parametro può essere vuoto.
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 una direzione per usare l'argomento sample.ini e controllare le stringhe di connessione e di query.
Nota
Il metodo Execute21 è una versione del metodo Execute (RDS). Se è necessario usare il metodo Execute per comunicare con ADO 2.1, effettuare una chiamata al metodo Execute21. Le funzionalità del metodo Execute in ADO 2.5 e versioni successive sono un superset delle funzionalità fornite per lo stesso metodo in ADO 2.1.