Metodo Execute (Servizi Desktop remoto)

Esegue la richiesta e crea un recordset ADO da usare 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.Execute(ConnectionString As String, HandlerString As String, QueryString As String, lFetchOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters, [lcid As Long], [pInformation])  

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 in due parti 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 contiene gli argomenti da passare al gestore. I dettagli relativi alla modalità di interpretazione della stringa degli argomenti sono specifici di ogni 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.

QueryString
Un comando nel linguaggio di comando supportato dal provider OLE DB identificato nella stringa di connessione. Per i provider basati su SQL, QueryString 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.

Se viene usato 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 file .ini. Per impostazione predefinita, viene usato il file Msdfmap.ini.

lFetchOptions
Indica il tipo di recupero asincrono.

Per altre informazioni, vedere FetchOptions Property (RDS).

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.

Le opzioni ReadOnly, NoBatch e GetHiddenColumns si escludano a vicenda, tuttavia è 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 e 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.

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 una direzione per usare l'argomento sample.ini e controllare le stringhe di connessione e di query.

Si applica a

Oggetto DataFactory (RDSServer)