CHAMAR (Função CHAMAR)
Importante Cuidado A edição incorreta do Registro pode danificar seriamente o sistema operacional, exigindo que ele seja reinstalado. A Microsoft não pode garantir que problemas resultantes da edição incorreta do Registro possam ser resolvidos. Antes de editar o Registro, faça backup de dados importantes. Para obter as informações mais recentes sobre como usar e proteger o Registro do computador, consulte a Ajuda do Microsoft Windows.
Este artigo descreve a sintaxe da fórmula e o uso da FUNÇÃO CHAMAR no Microsoft Excel.
Observação A função CHAMAR não está disponível no Excel Web App.
Descrição
Chama um procedimento em uma biblioteca de vínculos dinâmicos ou recurso de código. Há duas formas de sintaxe desta função. Use a sintaxe 1 apenas com um recurso de código previamente registrado que use argumentos da função REGISTRO. Use a sintaxe 2a ou 2b para registrar e chamar simultaneamente um recurso de código.
Importante Esta função é fornecida apenas para usuários avançados. Caso use a função CHAMAR incorretamente, poderá causar erros que exigirão que você reinicialize o computador. Essa função só está disponível em uma folha de macros do Excel.
Sintaxe
Sintaxe 1
Usada com REGISTRO
CHAMAR(ident_registro,[argumento1],...])
Sintaxe 2
Usada sozinha (no Microsoft Excel para Windows)
Ident_registro é o valor retornado por uma função REGISTRO ou IDENT.REGISTRO executada anteriormente.
CHAMAR(texto_módulo,procedimento,tipo_texto,[argumento1],...])
A sintaxe da função CHAMAR tem os seguintes ARGUMENTOS :
- Texto_módulo Obrigatório. Texto entre aspas que especifica o nome da DLL (biblioteca de vínculo dinâmico) que contém o procedimento no Microsoft Excel para Windows.
- Procedimento Obrigatório. Texto que especifica o nome da função da DLL no Microsoft Excel para Windows. Você também pode usar o valor ordinal da função da instrução EXPORTS do arquivo de definição de módulo (.DEF). O valor ordinal não deve estar em forma de texto.
- Tipo_texto Obrigatório. Texto que especifica o tipo de dados do valor de retorno e os tipos de dados de todos os argumentos para a DLL ou o recurso de código. A primeira letra de tipo_texto especifica o valor de retorno. Os códigos usados para tipo_texto encontram-se descritos de forma detalhada em Usando as funções CHAMAR e REGISTRO. No caso de DLLs autônomas ou recursos de código (XLLs), você pode omitir este argumento.
- Argumento1,... Opcional. Os argumentos a serem passados ao procedimento.
Exemplo
A fórmula de macro a seguir registra a função ObterContagemMarcaEscala do Microsoft Windows de 32 bits. ObterContagemMarcaEscala retorna o número de milissegundos que se passaram desde que o Microsoft Windows foi iniciado.
REGISTRO("Kernel32"; "ObterContagemMarcaEscala"; "J")
Considerando que tal função REGISTRO esteja na célula A5, depois que a sua macro registrar ObterContagemMarcaEscala, você poderá usar a função CHAMAR para retornar o número de milissegundos que se passaram:
CHAMAR(A5)