Metodo Execute21 (RDS)
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 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.Execute21(ConnectionString As String, HandlerString As String, QueryString As String, lMarshalOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters)
Parametri
ConnectionString
Stringa utilizzata 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 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 (anche se la stringa degli argomenti può contenere virgole aggiuntive). Gli argomenti sono facoltativi.
QueryString
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, questo potrebbe non essere un'istruzione di query Transact-SQL.
Inoltre, se viene usato un gestore (ed è consigliabile usare un gestore), il gestore può modificare o sostituire il valore specificato qui. Ad esempio, il gestore sostituisce in genere queryString con una stringa di query dal relativo file .ini. Per impostazione predefinita, viene usato il file Msdfmap.ini.
lMarshalOptions
Consente di impostare le opzioni di marshalling sul set di righe/recordset restituito.
tableID
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 usando il valore specificato qui e il parametro QueryString viene ignorato.
lExecuteOptions
Maschera di bit delle opzioni di esecuzione:
1=ReadOnly Il recordset verrà aperto usando adLockReadOnly.
2=NoBatch L'oggetto recordset verrà aperto utilizzando adLockOptimistic.
4=AllParamInfoSupplied Il chiamante garantisce che le informazioni sui parametri per tutti i parametri vengano fornite in pParameters.
8=GetInfo 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 L'oggetto recordset verrà aperto utilizzando adLockBatchOptimistic e tutte le colonne nascoste verranno incluse nel recordset.
Anche se ReadOnly, NoBatch e GetHiddenColumns sono opzioni che si escludono a vicenda, non è un errore impostarne più di una. Se sono impostate più opzioni, GetHiddenColumns ha la precedenza su tutte le altre opzioni, seguita da ReadOnly. Se non vengono specificate opzioni, per impostazione predefinita, il recordset viene aperto utilizzando adLockBatchOptimistic ma le colonne nascoste non sono incluse nel recordset.
pParameters
Variante che contiene una matrice sicura 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 parametro HandlerString può essere Null. Ciò che si verifica 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à l'argomento come direzione per usare il sample.ini per controllare le stringhe di connessione e di query.
Nota
Il metodo Execute21 è una versione del metodo Execute (RDS). Dove è necessario usare il metodo Execute per comunicare con ADO 2.1, è possibile chiamare invece il 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.