Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Pagetitle
ExecInDllRun
ExecInDllRun

Executa uma função com nome pré-definida de determinado em uma DLL (Dynamic-link library , ou Biblioteca de vinculo dinâmica), previamente carregada no TOTVS|SmartClient através da função ExecInDLLOpen().

O nome da função que irá ser chamada é : ExecInClientDLL .

Sintaxe

Bloco de código
collapsefalse
cRet := ExecInDllRun( < nHandle >, < nOpc >, < cStrInput > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

nHandle

caractere

Indica o handle da DLL obtida através da função ExecInDLLOpen().

X

 


nOpc

numérico

Informa um parâmetro numérico inteiro para a função pré-definida na

Indica a opção que será executada pela DLL.

X

 


cStrInput

caractere

Informa uma string, limitado a 255 bytes

Indica o buffer, no formato caracter, que será

recebida

recebido pela DLL

como um ponteiro de caracteres ou char * . Caso

Esse mesmo parametro será utilizado apenas para input de dados na DLL.

 Caso seja necessário informar um parâmetro maior, utilize a função ExeDLLRun2.

X

 

Observações

...


Retorno

O retorno da função será um buffer no formato caracter de até 255 bytes

...

.

Exemplo (DLL)


...

Exemplos

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
// Fonte de exemplo c++ 
// Deve ser compilado gerando uma DLL 32 bits, chamada "tstdll.dll"
// para ser usada no exemplo em AdvPL. Esta DLL deve ser copiada para a pasta do SmartClient.EXE
 
 
extern "C" __declspec(dllexport) void ExecInClientDLL( int nOPCidCommand, char * cStrInputbuffParam, char * cStrReturnbuffOutput, int nRetMaxSize buffLen)
{
 
	switch  if( nOpc == 1 )
  {
    strcpy(cStrReturn,"Retorno 01");
  }
  else if ( nOpc == 2 )
  {
    strcpy(cStrReturn,"Retorno 02");
  }
}
(idCommand)
	{
	case COMMAND1:
	{
		strcpy(buffOutput, "Comando 1");
		return;
	}
	case COMMAND2:
	{
		strcpy(buffOutput, "Comando 2");
		return;
	}

	default:
		strcpy(buffOutput, "Comando inválido");
		return;
	}
}

Observações

  • A função executada dentro da DLL pode escrever um retorno em string de até 255 bytes. Caso seja necessário um retorno maior, utilize a função ExeDLLRun2.
  • Para o nome da função na DLL, é obrigatorio utilizar ExecInClientDLL, com a declaração/assinatura abaixo especificada, para o correto funcionamento da implementação.


Nota
icontrue
titleAtenção

Como pode ser observado, a dll desenvolvida para ser executada com a função ExecinDLLRun tem uma assinatura diferente da utilizada em ExeDLLRun3, por isso não são compativeis compatíveis e podem causar erros fatais na execução.

Quando a função ExecInClientDLL é chamada através da função AdvPL ExecInDLLRun(), o buffer de retorno suporta apenas 255 bytes. Caso seja necessário um retorno maior, utilize a função ExeDLLRun2()

Exemplo (AdvPL)



Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
#define MB_OK                       0
#define MB_OKCANCEL                 1
#define MB_YESNO                    4
#define MB_ICONHAND                 16
#define MB_ICONQUESTION             32
#define MB_ICONEXCLAMATION          48
#define MB_ICONASTERISK             64

User Function ExemploDllTeste()
 
Local hHdl := 0,buffer cParm := "", cRet xRet1 := 0
// Abre Dll
hHdl := ExecInDLLOpen( "TSTDLLDllTeste.DLLdll" )
 
// ----------------------------------------------------------------
// Envia Nestacomando para chamadaexecução, repare que estamos
// usando a função ExecInClientDLL (dentro da DLL) receberá 1 em nOpc, e a string "Teste 1" em cStrInput.
// Será retornado na variável AdvPL cRet o conteúdo "Retorno 01", escrito pela DLL no buffer de retorno cStrReturn
cParm := "Teste 1"
nOpc := 1
cRet  opção "1" no momento de chamar a DLL.
// ----------------------------------------------------------------

// ExecInDllRun não retorna valor da DLL
buffer:= "Executando a partir da ExecInDllRun..."
xRet1 := ExecInDllRun( hHdl, 1, buffer )
MessageBox("Retorno da ExeDllRun: " + xRet1, "ExeDllRun", MB_ICONEXCLAMATION)
  
// ExecInDllRun retorna valor numérico da DLL
buffer:= "Executando a partir da ExeDllRun..."
xRet2 := ExecInDllRun( hHdl, 2, @buffer )
MessageBox("Retorno da ExeDllRun: " + xRet2, "ExeDllRun", MB_ICONEXCLAMATION)

// ExecInDllRun retorna valor numérico da DLL
buffer:= "Executando a partir da ExeDllRun..."
xRet3 := ExecInDllRun( hHdl, nOpc3, cParm@buffer )

alertMessageBox("Retorno da ExecInDllRunExeDllRun: " + cRet)
xRet3, "ExeDllRun", MB_ICONEXCLAMATION)

// ----------------------------------------------------------------
// Fecha a DLL
ExecInDllClose( hHdl )
 
Return

Preview

Image Added


Image Added


Image Added

Veja também