TOTVSTEC

Árvore de páginas

Função que executa uma stored procedure no banco de dados atual.

Sintaxe

TCSPExec( < cStoredProcedure >, [ xParam ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cStoredProcedure

caractere

Nome da stored procedure a ser executada.

X


xParam

caractere

Indica uma ou mais expressões, separadas por vírgula, indicando os parâmetros necessários para a execução da stored procedure.



Retorno

Nome

Tipo

Descrição

aResult

vetor

Retorna um array que contêm os valores de retorno da stored procedure. O retorno será nulo se nenhum valor for retornado pela stored procedure ou ocorrer algum erro na chamada da procedure. [attention] Esta função não está disponível para uso com RPODB=SQLITE. [attention]

Observações

  • Quando utilizar o tipo Data como input na Procedure, use a função DToS
  • O Tamanho máximo de cada valor informado como parâmetro ou retorno da Stored Procedure não deve exceder 999 bytes.
  • O Tamanho total de todos os parâmetros informados ou retornados não deve exceder 4 KB.

Exemplos

Exemplo de stored procedure já existente no banco de dados.

Create Procedure USRTESTE( @inValue int, @outStr char(64) OUTPUT, @outValue int OUTPUT) As
Begin
set @outStr = 'Teste'
set @outValue = @inValue + 3
End

Programa de teste para utilizar a função TCSPExec.

User Function exemplo()

Local aResult := {}
aResult := TCSPEXEC("USRTESTE", 100)

IF empty(aResult)
Conout('Erro na execução da Stored Procedure : '+TcSqlError())
Else
Conout("Retorno String : "+aResult[1])
Conout("Retorno Numerico : "+str(aResult[2]))
MsgInfo("Procedure Executada")
Endif

Return

Veja também

  • Sem rótulos