Método Execute21 (RDS)
Executa a solicitação e cria um conjunto de registros ADO para uso no ADO 2.1.
Importante
A partir do Windows 8 e do Windows Server 2012, os componentes do servidor RDS não estão mais incluídos no sistema operacional Windows (confira Windows 8 e Manual de Compatibilidade do Windows Server 2012 para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Os aplicativos que usam o RDS devem migrar para o Serviço de Dados do WCF.
Sintaxe
object.Execute21(ConnectionString As String, HandlerString As String, QueryString As String, lMarshalOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters)
Parâmetros
ConnectionString
Uma cadeia de caracteres usada para se conectar ao provedor OLE DB em que a solicitação será enviada para execução. Se um manipulador for especificado por meio de HandlerString, ele poderá editar ou substituir a cadeia de conexão.
HandlerString
A cadeia de caracteres identifica o manipulador a ser usado com essa execução. A cadeia de caracteres contém duas partes. A primeira parte contém o nome (ProgID) do manipulador a ser usado. A segunda parte da cadeia de caracteres contém os argumentos a serem transmitidos para o manipulador. A forma como a cadeia de caracteres de argumentos é interpretada é específica do manipulador. As duas partes são separadas pela primeira instância de uma vírgula na cadeia de caracteres (embora a cadeia de caracteres de argumentos possa conter vírgulas adicionais). Os argumentos são opcionais.
QueryString
Um comando na linguagem de comandos compatível com o provedor OLE DB identificado na cadeia de conexão. Para os provedores baseados em SQL, ele pode conter uma instrução de comando Transact-SQL, mas para os provedores não SQL (por exemplo, o MSDataShape), essa pode não ser uma instrução de consulta Transact-SQL.
Além disso, se um manipulador estiver sendo usado (e é altamente recomendável que um manipulador seja usado), o manipulador poderá alterar ou substituir o valor especificado aqui. Por exemplo, o manipulador normalmente substitui QueryString por uma cadeia de consulta do arquivo.ini. Por padrão, o arquivo Msdfmap.ini é usado.
lMarshalOptions
Usado para definir as opções de marshaling no conjunto de linhas/no conjunto de registros que está sendo retornado.
TableID
Uma variante do tipo VT_EMPTY ou VT_BSTR. Se esse valor for do tipo VT_EMPTY, ele será ignorado. Se ele for do tipo VT_BSTR, o conjunto de registros será criado com adCmdTableDirect usando o valor especificado aqui e o parâmetro QueryString será ignorado.
lExecuteOptions
Um bitmask das opções de execução:
1=ReadOnly O conjunto de registros será aberto por meio de adLockReadOnly.
2=NoBatch O conjunto de registros será aberto por meio de adLockOptimistic.
4=AllParamInfoSupplied O chamador garante que as informações de todos os parâmetros sejam fornecidas em pParameters.
8=GetInfo As informações de parâmetro da consulta serão obtidas do provedor OLE DB e retornadas no parâmetro pParameters. A consulta não é executada e nenhum conjunto de registros é retornado.
16=GetHiddenColumns O conjunto de registros será aberto por meio de adLockBatchOptimistic e todas as colunas ocultas serão incluídas no conjunto de registros.
Embora ReadOnly, NoBatch e GetHiddenColumns sejam opções mutuamente exclusivas, não é um erro definir mais de uma delas. Se várias opções forem definidas, GetHiddenColumns terá precedência sobre todas as outras opções, seguidas de ReadOnly. Se nenhuma opção for especificada, por padrão, o conjunto de registros será aberto por meio de adLockBatchOptimistic, mas as colunas ocultas não serão incluídas no conjunto de registros.
pParameters
Uma variante que contém uma matriz segura de definições de parâmetro. Se a opção GetInfo for especificada em lExecuteOptions, esse parâmetro será usado para retornar as definições de parâmetro obtidas do provedor OLE DB. Caso contrário, esse parâmetro poderá estar vazio.
Comentários
O parâmetro HandlerString pode ser nulo. O que ocorre nesse caso depende de como o servidor RDS está configurado. Uma cadeia de caracteres de manipulador de "MSDFMAP.handler" indica que o manipulador fornecido pela Microsoft (Msdfmap.dll) deve ser usado. Uma cadeia de caracteres de manipulador de "MASDFMAP.handler,sample.ini" indica que o manipulador de Msdfmap.dll deve ser usado e que o argumento "sample.ini" deve ser transmitido para o manipulador. O MSDFMAP.dll interpretará o argumento como uma instrução para usar o sample.ini a fim de verificar as cadeias de conexão e de consulta.
Observação
O método Execute21 é uma versão do método Execute (RDS). Quando você precisar usar o método Execute para se comunicar com o ADO 2.1, o método Execute21 poderá ser chamado. As funcionalidades do método Execute no ADO 2.5 e posterior são um superconjunto das funcionalidades fornecidas para o mesmo método no ADO 2.1.