Metodo Execute (RDS)

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 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.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
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
Stringa in due parti che 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 contiene argomenti da passare al gestore. I dettagli sulla 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
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, questa potrebbe non essere 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 relativo file .ini. Per impostazione predefinita, viene usato il file Msdfmap.ini.

lFetchOptions
Indica il tipo di recupero asincrono.

Per altre informazioni, vedere Proprietà FetchOptions (RDS).

tableID
Un Variant 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 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 Il recordset verrà aperto utilizzando adLockBatchOptimistic e tutte le colonne nascoste verranno incluse nel recordset.

ReadOnly, NoBatch e GetHiddenColumns si escludono a vicenda; Tuttavia, non genera un errore per impostare più di uno di essi. Se sono impostate più opzioni, GetHiddenColumns ha la precedenza su tutti gli altri, seguito da ReadOnly. Se non vengono specificate opzioni, per impostazione predefinita, il recordset viene aperto utilizzando adLockBatchOptimistic e le colonne nascoste non sono incluse nel recordset.

pParameters
Variant 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.

lcid
LCID usato per compilare eventuali errori restituiti in pInformation.

pInformation
Puntatore all'errore di informazioni restituito da Execute. Se NULL, non vengono restituite informazioni sull'errore.

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

Si applica a

oggetto DataFactory (RDSServer)