Share via


Método Application.DDEInitiate (Access)

Use a função DDEInitiate para iniciar uma conversa de DDE (troca de dados dinâmica) com outro aplicativo. A função DDEInitiate abre um canal DDE para transferência de dados entre um servidor DDE e um aplicativo cliente.

Sintaxe

expressão. DDEInitiate (Aplicativo, Tópico)

expressão Uma variável que representa um Aplicativo objeto.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Aplicativo Obrigatório String Uma expressão de cadeia de caracteres que identifica um aplicativo que pode participar de uma conversação DDE. Normalmente, o argumento do aplicativo é o nome de um arquivo .exe (sem a extensão .exe) para um aplicativo baseado no Microsoft Windows, como o Microsoft Excel.
Tópico Obrigatório String Uma expressão de cadeia de caracteres que é o nome de um tópico reconhecido pelo argumento do aplicativo . Consulte a documentação do aplicativo para obter uma lista de tópicos.

Valor de retorno

Variant

Comentários

Por exemplo, se você desejar transferir dados de uma planilha do Microsoft Excel para um banco de dados do Microsoft Access, você pode usar a função DDEInitiate para abrir um canal entre os dois aplicativos. Neste exemplo, o Microsoft Access atua como o aplicativo cliente e o Microsoft Excel atua como o aplicativo de servidor.

Se tiver êxito, a função DDEInitiate inicia uma conversação DDE com o aplicativo e o tópico especificados pelos argumentos application e topic e retorna um valor inteiro longo. Esse valor de retorno representa um número de canal exclusivo que identifica um canal através do qual os dados a transferência pode ocorrer. Esse número de canal subsequentemente é usado com outras funções e instruções DDE.

Se o aplicativo ainda não estiver em execução ou se ele estiver em execução, mas não reconhecer o argumento do tópico ou não oferecer suporte ao DDE, a função DDEInitiate retornará um erro em tempo de execução.

O valor do argumento de tópico depende do aplicativo especificado pelo argumento do aplicativo . Para aplicativos que utilizam documentos ou arquivos de dados, os nomes de tópicos válidos sempre incluem os nomes desses arquivos.

Observação

O número máximo de canais que podem ser abertos simultaneamente é determinado pelo Windows e pela memória e recursos do computador. Se você não estiver usando um canal, poupar os recursos terminando-o com uma instrução DDETerminate ou DDETerminateAll.

Caso você precise manipular objetos de outro aplicativo a partir do Microsoft Access, convém considerar o uso da Automação.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.