Função DDEIniciar

Aplica-se A
Access para Microsoft 365 Access 2021 Access 2019 Access 2016

Pode utilizar a função DDEIniciar para iniciar uma conversação DDE (Dynamic Data Exchange) com outra aplicação. A função DDEInitiate abre um canal DDE para transferência de dados entre um servidor DDE e um aplicativo cliente.

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

Sintaxe

DDEInitiate(aplicação, tópico)

A sintaxe da função DDEIniciar tem estes argumentos:

Argumento Descrição
Aplicação Uma expressão de cadeia que identifica uma aplicação que pode participar numa conversação DDE. Normalmente, o argumento de aplicação é o nome de um ficheiro .exe (sem a extensão .exe) de uma aplicação baseada no Microsoft Windows, como o Excel.
tópico Uma expressão de cadeia que é o nome de um tópico reconhecido pelo argumento da aplicação . Consulte a documentação da aplicação para obter uma lista de tópicos.

    

Comentários

Se for bem-sucedida, a função DDEIniciar inicia uma conversação DDE com a aplicação e o tópico especificados pelos argumentos aplicação e tópico e, em seguida, devolve um valor Número Inteiro Longo. Este valor devolvido representa um número de canal exclusivo que identifica um canal através do qual a transferência de dados pode ser efetuada. Este número de canal é subsequentemente utilizado com outras funções e instruções DDE.

Se a aplicação ainda não estiver em execução ou se estiver em execução, mas não reconhecer o argumento topic ou não suportar DDE, a função DDEInitiate devolve um erro em tempo de execução.

O valor do argumento tópico depende da aplicação especificada pelo argumento aplicação . Para aplicativos que usam documentos ou arquivos de dados, os nomes de tópicos válidos geralmente incluem os nomes desses arquivos.

Nota

O número máximo de canais que podem ser abertos simultaneamente é determinado pelo Microsoft Windows e pela memória e recursos do seu computador. Se não estiver a utilizar um canal, deve conservar os recursos ao terminá-lo com uma instrução DDETerminate ou DDETerminateAll .

Sugestão

Se precisar de manipular objetos de outra aplicação a partir do Access, convém considerar a utilização da automatização.