Метод Execute21 (служба удаленных рабочих столов)

Выполняет запрос и создает набор записей ADO для использования в ADO 2.1.

Важно!

Начиная с Windows 8 и Windows Server 2012 компоненты сервера RDS больше не включаются в операционную систему Windows (дополнительные сведения см. в Windows 8 и Windows Server 2012 совместимости). Клиентские компоненты RDS будут удалены в следующей версии Windows. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Приложения, использующие RDS, должны перейти на службу данных WCF.

Синтаксис

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

Параметры

Connectionstring
Строка, используемая для подключения к поставщику OLE DB, куда будет отправлен запрос на выполнение. Если обработчик указан с помощью HandlerString, он может изменить или заменить строку подключения.

HandlerString
Строка идентифицирует обработчик, используемый при этом выполнении. Строка содержит две части. Первая часть содержит имя (ProgID) используемого обработчика. Вторая часть строки содержит аргументы, передаваемые обработчику. Способ интерпретации строки аргументов зависит от обработчика. Две части разделяются первым экземпляром запятой в строке (хотя строка аргументов может содержать дополнительные запятые). Аргументы являются необязательными.

QueryString
Команда на языке команд, поддерживаемом поставщиком OLE DB, указанным в строке подключения. Для поставщиков на основе SQL он может содержать командную инструкцию Transact-SQL, но для поставщиков, отличных от SQL (например, MSDataShape), это может быть не инструкция запроса Transact-SQL.

Кроме того, если используется обработчик (и настоятельно рекомендуется использовать обработчик), обработчик может изменить или заменить указанное здесь значение. Например, обработчик обычно заменяет QueryString строкой запроса из файла .ini. По умолчанию используется файл Msdfmap.ini.

lMarshalOptions
Используется для задания параметров маршалинга возвращаемого набора строк или набора записей.

TableID
Вариант типа VT_EMPTY или VT_BSTR. Если это значение имеет тип VT_EMPTY, оно игнорируется. Если он имеет тип VT_BSTR, набор записей создается с помощью adCmdTableDirect , используя указанное здесь значение, а параметр QueryString игнорируется.

lExecuteOptions
Битовая маска параметров выполнения:

1 =ReadOnly . Набор записей будет открыт с помощью adLockReadOnly.

2=NoBatch . Набор записей будет открыт с помощью adLockOptimistic.

4=AllParamInfoSupplied Вызывающий объект гарантирует, что сведения о параметрах для всех параметров предоставляются в pParameters.

8 = Сведения о параметре GetInfo для запроса будут получены от поставщика OLE DB и возвращены в параметре pParameters . Запрос не выполняется, и набор записей не возвращается.

16=GetHiddenColumns. Набор записей будет открыт с помощью adLockBatchOptimistic и все скрытые столбцы будут включены в набор записей.

Хотя ReadOnly, NoBatch и GetHiddenColumns являются взаимоисключающими параметрами, установка нескольких из них не является ошибкой. Если задано несколько параметров, GetHiddenColumns имеет приоритет над всеми остальными параметрами, а затем — ReadOnly. Если параметры не указаны, по умолчанию набор записей открывается с помощью adLockBatchOptimistic , но скрытые столбцы не включаются в набор записей.

pParameters
Вариант, содержащий безопасный массив определений параметров. Если параметр GetInfo был указан в lExecuteOptions, этот параметр используется для возврата определений параметров, полученных от поставщика OLE DB. В противном случае этот параметр может быть пустым.

Комментарии

Параметр HandlerString может иметь значение NULL. Что происходит в этом случае, зависит от того, как настроен сервер RDS. Строка обработчика MSDFMAP.handler указывает, что следует использовать обработчик, предоставленный корпорацией Майкрософт (Msdfmap.dll). Строка обработчика "MASDFMAP.handler,sample.ini" указывает, что следует использовать обработчик Msdfmap.dll и что аргумент "sample.ini" должен быть передан обработчику. MSDFMAP.dll интерпретирует аргумент как направление использования sample.ini для проверка строк подключения и запроса.

Примечание

Метод Execute21 является версией метода Execute (RDS). Если для взаимодействия с ADO 2.1 необходимо использовать метод Execute21 , можно вызвать метод Execute21 . Возможности метода Execute в ADO 2.5 и более поздних версиях являются надмножеством возможностей, предоставляемых для того же метода в ADO 2.1.

Применение

Объект DataFactory (RDSServer)