Método Execute21 (RDS)

Ejecuta la solicitud y crea un conjunto de registros de ADO para su uso en ADO 2.1.

Importante

A partir de Windows 8 y Windows Server 2012, los componentes del servidor RDS ya no se incluyen en el sistema operativo Windows (para obtener más información, consulte Windows 8 y la Guía de compatibilidad de Windows Server 2012, edición Cookbook). Los componentes de cliente de RDS se eliminarán en una versión futura de Windows. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. Las aplicaciones que usan RDS deben migrar al servicio de datos WCF.

Sintaxis

  
object.Execute21(ConnectionString As String, HandlerString As String, QueryString As String, lMarshalOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters)  

Parámetros

ConnectionString
Cadena usada para conectarse al proveedor OLE DB donde se enviará la solicitud para su ejecución. Si se especifica un controlador mediante HandlerString, puede editar o reemplazar la cadena de conexión.

HandlerString
La cadena identifica el controlador que se va a usar con esta ejecución. La cadena contiene dos partes. La primera parte contiene el nombre (ProgID) del controlador que se va a usar. La segunda parte de la cadena contiene argumentos que se van a pasar al controlador. Cómo se interpreta la cadena de argumentos es específico del controlador. Las dos partes están separadas por la primera instancia de una coma en la cadena (aunque la cadena de argumentos puede contener comas adicionales). Los argumentos son opcionales.

QueryString
Un comando en el lenguaje de comandos admitido por el proveedor OLE DB identificado en la cadena de conexión. En el caso de los proveedores basados en SQL, podría contener una instrucción de comando Transact-SQL, pero para proveedores que no son SQL (por ejemplo, MSDataShape), puede que no sea una instrucción de consulta Transact-SQL.

Además, si se usa un controlador (y se recomienda encarecidamente que se use un controlador), el controlador puede modificar o reemplazar el valor especificado aquí. Por ejemplo, el controlador normalmente reemplaza QueryString por una cadena de consulta de su archivo .ini. De forma predeterminada, se usa el archivo Msdfmap.ini.

lMarshalOptions
Se usa para establecer las opciones de serialización en el conjunto de filas o el conjunto de registros que se devuelve.

TableID
Variante de tipo VT_EMPTY o VT_BSTR. Si este valor es de tipo VT_EMPTY, se omite. Si es de tipo VT_BSTR, el conjunto de registros se crea mediante adCmdTableDirect con el valor especificado aquí y se omite el parámetro QueryString.

lExecuteOptions
Máscara de bits de las opciones de ejecución:

1=ReadOnly El conjunto de registros se abrirá mediante adLockReadOnly.

2=NoBatch El conjunto de registros se abrirá mediante adLockOptimistic.

4=AllParamInfoSupplied El autor de la llamada garantiza que la información de parámetros de todos los parámetros se proporcione en pParameters.

8=GetInfo La información de parámetro para la consulta se obtendrá del proveedor OLE DB y se devolverá en el parámetro pParameters. La consulta no se ejecuta y no se devuelve ningún conjunto de registros.

16=GetHiddenColumns El conjunto de registros se abrirá mediante adLockBatchOptimistic y las columnas ocultas se incluirán en el conjunto de registros.

Aunque ReadOnly, NoBatch y GetHiddenColumns son opciones mutuamente excluyentes, no es un error establecer más de uno de ellos. Si se establecen varias opciones, GetHiddenColumns tiene prioridad sobre todas las demás opciones, seguidas de ReadOnly. Si no se especifica ninguna opción, de forma predeterminada, el conjunto de registros se abre mediante adLockBatchOptimistic, pero las columnas ocultas no se incluyen en el conjunto de registros.

pParameters
Variante que contiene una matriz segura de definiciones de parámetros. Si la opción GetInfo se especificó en lExecuteOptions, este parámetro se usa para devolver las definiciones de parámetro obtenidas del proveedor OLE DB. De lo contrario, este parámetro puede estar vacío.

Comentarios

El parámetro HandlerString puede ser null. Lo que sucede en este caso depende de cómo se configura el servidor RDS. Una cadena de controlador de "MSDFMAP.handler" indica que se debe usar el controlador proporcionado por Microsoft (Msdfmap.dll). Una cadena de controlador de "MASDFMAP.handler,sample.ini" indica que se debe usar el controlador de Msdfmap.dll y que el argumento "sample.ini" debe pasarse al controlador. MSDFMAP.dll interpretará el argumento como una dirección para usar el sample.ini para comprobar las cadenas de conexión y consulta.

Nota

El método Execute21 es una versión del método Execute (RDS). Cuando necesite usar el método Execute para comunicarse con ADO 2.1, puede llamarse al método Execute21 en su lugar. Las funcionalidades del método Execute en ADO 2.5 y versiones posteriores son un superconjunto de las funcionalidades proporcionadas para el mismo método en ADO 2.1.

Se aplica a

Objeto DataFactory (RDSServer)