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 (consulte o Windows 8 e o Windows Server 2012 Compatibility Cookbook para obter mais detalhes). Os componentes do cliente RDS serão removidos em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Os aplicativos que usam RDS devem migrar para WCF Data Service.
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 usando 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 argumentos a serem passados 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 no idioma de comando compatível com o provedor OLE DB identificado na cadeia de conexão. Para provedores baseados em SQL, ele pode conter uma instrução de comando Transact-SQL, mas para provedores não SQL (por exemplo, MSDataShape) isso pode não ser uma instrução de consulta Transact-SQL.
Além disso, se um manipulador estiver sendo usado (e for 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 caracteres de consulta de seu arquivo .ini. Por padrão, o arquivo Msdfmap.ini é usado.
lMarshalOptions
Usado para definir as opções de marshaling no conjunto de linhas/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 for do tipo VT_BSTR, o conjunto de registros será criado usando adCmdTableDirect usando o valor especificado aqui e o parâmetro QueryString será ignorado.
lExecuteOptions
Uma máscara de bits das opções de execução:
1= ReadOnly O conjunto de registros será aberto usando adLockReadOnly.
2=NoBatch O conjunto de registros será aberto usando adLockOptimistic .
4=AllParamInfoSupplied O chamador garante que as informações de parâmetro para todos os parâmetros sejam fornecidas em pParameters.
8=As informações do parâmetro GetInfo para a 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 usando 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 estiverem definidas, GetHiddenColumns terá precedência sobre todas as outras opções, seguida por ReadOnly . Se nenhuma opção for especificada, por padrão, o conjunto de registros será aberto usando 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 foi 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.
Observações
O parâmetro HandlerString pode ser nulo. O que ocorre nesse caso depende de como o servidor RDS é 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 passado para o manipulador. MSDFMAP.dll interpretará o argumento como uma direção para usar o sample.ini para verificar as cadeias de conexão e consulta.
Nota
O método Execute21 é uma versão do método Execute (RDS). Quando você precisa usar o método Execute para se comunicar com o ADO 2.1, o método Execute21 pode ser chamado. Os recursos do método Execute no ADO 2.5 e posterior são um superconjunto dos recursos fornecidos para o mesmo método no ADO 2.1.