Biblioteca de Gerenciamento do Dynamic Data Exchange

  • Artigo

Dynamic Data Exchange (DDE) é uma forma de comunicação entre processos que usa memória compartilhada para trocar dados entre aplicativos. Os aplicativos podem usar o DDE para transferências de dados únicas e para intercâmbios e atualizações contínuas de dados.

Nesta seção

Nome Descrição
Sobre o DDEML Discute a troca dinâmica de dados.
Conceitos básicos Discute os principais conceitos relativos à troca dinâmica de dados.
Gerenciamento de Conversas Discute conversas entre um cliente e um servidor.
Gerenciamento de Dados Discute como os objetos de memória passam dados de um aplicativo para outro.
Aplicativos de monitoramento Discute como os elementos da Biblioteca de Gerenciamento de Intercâmbio de Dados Dinâmicos podem ser usados para criar um aplicativo que monitora a atividade de troca dinâmica de dados no sistema.
Serviço de Nomes Discute como a Biblioteca de Gerenciamento do Dynamic Data Exchange possibilita que um aplicativo de servidor registre os nomes de serviço aos quais ele oferece suporte.
Gestão de Transações Discute como um cliente pode enviar transações para obter dados e serviços do servidor.
Referência DDEML Contém a referência de API.

Funções DDEML

Nome Descrição
DdeAbandonTransaction Abandona a transação assíncrona especificada e libera todos os recursos associados à transação.
DdeAccessData Fornece acesso aos dados no objeto DDE especificado. Um aplicativo deve chamar a função DdeUnaccessData quando terminar de acessar os dados no objeto.
DdeAddData Adiciona dados ao objeto DDE especificado. Um aplicativo pode adicionar dados a partir de qualquer deslocamento do início do objeto. Se novos dados se sobrepõem aos dados que já estão no objeto, os novos dados sobrescrevem os dados antigos nos bytes em que a sobreposição ocorre. O conteúdo de locais no objeto que não foram gravados são indefinidos.
DdeCallback Uma função de retorno de chamada definida pelo aplicativo usada com as funções DDEML (Dynamic Data Exchange Management Library). Ele processa transações DDE. O tipo PFNCALLBACK define um ponteiro para essa função de retorno de chamada. DdeCallback é um espaço reservado para o nome da função definida pelo aplicativo.
DdeClientTransaction Inicia uma transação de dados entre um cliente e um servidor. Somente um aplicativo cliente DDE pode chamar essa função, e o aplicativo pode usá-la somente depois de estabelecer uma conversa com o servidor.
DdeCmpStringHandles Compara os valores de duas alças de cadeia de caracteres. O valor de um identificador de cadeia de caracteres não está relacionado ao caso da cadeia de caracteres associada.
DdeConnect Estabelece uma conversa com um aplicativo de servidor que oferece suporte ao nome de serviço especificado e ao par de nomes de tópico. Se houver mais de um servidor, o sistema selecionará apenas um.
DdeConnectList Estabelece uma conversa com todos os aplicativos de servidor que oferecem suporte ao par de nomes de nome e tópicos de serviço especificados. Um aplicativo também pode usar essa função para obter uma lista de identificadores de conversa passando a função um identificador de conversa existente.
DdeCreateDataHandle Cria um objeto DDE e preenche o objeto com dados do buffer especificado. Um aplicativo DDE usa essa função durante transações que envolvem a transmissão de dados para o aplicativo parceiro.
DdeCreateStringHandle Cria um identificador que identifica a cadeia de caracteres especificada. Um aplicativo cliente ou servidor DDE pode passar o identificador de cadeia de caracteres como um parâmetro para outras funções DDEML (Dynamic Data Exchange Management Library).
DdeDesconectar Encerra uma conversa iniciada pela função DdeConnect ou DdeConnectList e invalida o identificador de conversa especificado.
DdeDisconnectList Destrói a lista de conversas especificada e encerra todas as conversas associadas à lista.
DdeEnableCallback Habilita ou desabilita transações para uma conversa específica ou para todas as conversas atualmente estabelecidas pelo aplicativo de chamada.
DdeFreeDataHandle Classifica um objeto DDE e exclui o identificador de dados associado ao objeto.
DdeFreeStringHandle Libera um identificador de cadeia de caracteres no aplicativo de chamada.
DdeGetData Copia dados do objeto DDE especificado para o buffer local especificado.
DdeGetLastError Recupera o código de erro mais recente definido pela falha de uma função DDEML e redefine o código de erro para DMLERR_NO_ERROR.
DdeImpersonateClient Representa um aplicativo cliente DDE em uma conversa de cliente DDE.
DdeInitialize Registra um aplicativo com a Dynamic Data Exchange Management Library (DDEML). Um aplicativo deve chamar essa função antes de chamar qualquer outra função DDEML.
DdeKeepStringHandle Incrementa a contagem de uso associada ao identificador especificado. Essa função permite que um aplicativo salve um identificador de cadeia de caracteres passado para a função de retorno de chamada DDE do aplicativo. Caso contrário, um identificador de cadeia de caracteres passado para a função de retorno de chamada será excluído quando a função de retorno de chamada retornar. Essa função também deve ser usada para manter uma cópia de um identificador de cadeia de caracteres referenciado pela estrutura CONVINFO retornada pela função DdeQueryConvInfo.
DdeNameService Registra ou cancela o registro dos nomes de serviço suportados por um servidor DDE. Essa função faz com que o sistema envie transações XTYP_REGISTER ou XTYP_UNREGISTER para outros aplicativos cliente DDEML (Dynamic Data Exchange Management Library) em execução.
DdePostAdvise Envia uma transação XTYP_ADVREQ para a função de retorno de chamada DDE do aplicativo de chamada (servidor) para cada cliente com um loop de aconselhamento ativo no tópico e item especificados. Um aplicativo de servidor deve chamar essa função sempre que os dados associados ao nome do tópico ou ao par de nomes de item forem alterados.
DdeQueryConvInfo Recupera informações sobre uma transação DDE e sobre a conversa na qual a transação ocorre.
DdeQueryNextServer Recupera o próximo identificador de conversa na lista de conversas especificada.
DdeQueryString Copia o texto associado a um identificador de cadeia de caracteres em um buffer.
DdeReconectar Permite que um aplicativo DDEML (Dynamic Data Exchange Management Library) do cliente tente restabelecer uma conversa com um serviço que encerrou uma conversa com o cliente. Quando a conversa é restabelecida, o DDEML tenta restabelecer quaisquer loops de aconselhamento preexistentes.
DdeSetUserHandle Associa um valor definido pelo aplicativo a um identificador de conversa ou a um identificador de transação. Isso é útil para simplificar o processamento de transações assíncronas. Um aplicativo pode usar a função DdeQueryConvInfo para recuperar esse valor.
DdeUnaccessData Cancela o acesso a um objeto DDE. Um aplicativo deve chamar essa função depois de terminar de acessar o objeto.
DdeUninitialize Libera todos os recursos DDEML associados ao aplicativo de chamada.

Transações DDEML

Nome Descrição
XTYP_ADVDATA Informa ao cliente que o valor do item de dados foi alterado. A função de retorno de chamada do cliente DDE, DdeCallback, recebe essa transação depois de estabelecer um loop de aconselhamento com um servidor.
XTYP_ADVREQ Informa ao servidor que uma transação de aviso está pendente no par de nome de tópico e nome de item especificado e que os dados correspondentes ao par de nome de tópico e nome de item foram alterados. O sistema envia essa transação para a função de retorno de chamada DDE, DdeCallback, depois que o servidor chama a função DdePostAdvise.
XTYP_ADVSTART Um cliente usa a transação XTYP_ADVSTART para estabelecer um loop de aconselhamento com um servidor. Uma função de retorno de chamada do servidor DDE, DdeCallback, recebe essa transação quando um cliente especifica XTYP_ADVSTART como o parâmetro wType da função DdeClientTransaction.
XTYP_ADVSTOP Um cliente usa a transação XTYP_ADVSTOP para encerrar um loop de aconselhamento com um servidor. Uma função de retorno de chamada do servidor DDE, DdeCallback, recebe essa transação quando um cliente especifica XTYP_ADVSTOP na função DdeClientTransaction.
XTYP_CONNECT Um cliente usa a transação XTYP_CONNECT para estabelecer uma conversa. Uma função de retorno de chamada do servidor DDE, DdeCallback, recebe essa transação quando um cliente especifica um nome de serviço que o servidor oferece suporte (e um nome de tópico que não é NULL) em uma chamada para a função DdeConnect.
XTYP_CONNECT_CONFIRM Uma função de retorno de chamada do servidor DDE, DdeCallback, recebe a transação XTYP_CONNECT_CONFIRM para confirmar que uma conversa foi estabelecida com um cliente e para fornecer ao servidor o identificador de conversa. O sistema envia essa transação como resultado de uma transação XTYP_CONNECT ou XTYP_WILDCONNECT anterior.
XTYP_DISCONNECT A função de retorno de chamada DDE de um aplicativo, DdeCallback, recebe a transação XTYP_DISCONNECT quando o parceiro do aplicativo em uma conversa usa a função DdeDisconnect para encerrar a conversa.
XTYP_ERROR Uma função de retorno de chamada DDE, DdeCallback, recebe a transação XTYP_ERROR quando ocorre um erro crítico.
XTYP_EXECUTE Um cliente usa a transação XTYP_EXECUTE para enviar uma cadeia de caracteres de comando para o servidor. Uma função de retorno de chamada do servidor DDE, DdeCallback, recebe essa transação quando um cliente especifica XTYP_EXECUTE na função DdeClientTransaction.
XTYP_MONITOR A função de retorno de chamada DDE de um depurador DDE, DdeCallback, recebe a transação XTYP_MONITOR sempre que ocorre um evento DDE no sistema. Para receber essa transação, um aplicativo deve especificar o valor APPCLASS_MONITOR quando chama a função DdeInitialize.
XTYP_POKE Um cliente usa a transação XTYP_POKE para enviar dados não solicitados ao servidor. Uma função de retorno de chamada do servidor DDE, DdeCallback, recebe essa transação quando um cliente especifica XTYP_POKE na função DdeClientTransaction.
XTYP_REGISTER Uma função de retorno de chamada DDE, DdeCallback, recebe o tipo de transação XTYP_REGISTER sempre que um aplicativo de servidor DDEML usa a função DdeNameService para registrar um nome de serviço ou sempre que um aplicativo não-DDEML que oferece suporte ao tópico System é iniciado.
XTYP_REQUEST Um cliente usa a transação XTYP_REQUEST para solicitar dados de um servidor. Uma função de retorno de chamada do servidor DDE, DdeCallback, recebe essa transação quando um cliente especifica XTYP_REQUEST na função DdeClientTransaction.
XTYP_UNREGISTER Uma função de retorno de chamada DDE, DdeCallback, recebe a transação XTYP_UNREGISTER sempre que um aplicativo de servidor DDEML usa a função DdeNameService para cancelar o registro de um nome de serviço ou sempre que um aplicativo não-DDEML que oferece suporte ao tópico System é encerrado.
XTYP_WILDCONNECT A transação XTYP_WILDCONNECT permite que um cliente estabeleça uma conversa em cada um dos pares de nome de serviço e nome de tópico do servidor que correspondam ao nome de serviço e ao nome de tópico especificados. Uma função de retorno de chamada do servidor DDE, DdeCallback, recebe essa transação quando um cliente especifica um nome de serviço NULL, um nome de tópico NULL ou ambos em uma chamada para a função DdeConnect ou DdeConnectList.
XTYP_XACT_COMPLETE Uma função de retorno de chamada de cliente DDE, DdeCallback, recebe a transação XTYP_XACT_COMPLETE quando uma transação assíncrona, iniciada por uma chamada para a função DdeClientTransaction, é concluída.

Estruturas DDEML

Nome Descrição
CONTEXTO CONVCONTEXT Contém informações fornecidas por um aplicativo cliente DDE. As informações são úteis para conversas DDE especializadas ou entre idiomas.
CONVINFO Contém informações sobre uma conversa DDE.
DDEML_MSG_HOOK_DATA Contém informações sobre uma mensagem DDE e fornece acesso de leitura aos dados referenciados pela mensagem. Esta estrutura destina-se a ser usada por um aplicativo de monitoramento DDEML.
MONCBSTRUCT Contém informações sobre a transação DDE atual. Um aplicativo de depuração DDE pode usar essa estrutura ao monitorar transações que o sistema passa para as funções de retorno de chamada DDE de outros aplicativos.
MONCONVSTRUCT Contém informações sobre uma conversa DDE. Um aplicativo de monitoramento DDE pode usar essa estrutura para obter informações sobre uma conversa que foi estabelecida ou encerrada.
MONERRSTRUCT Contém informações sobre o erro DDE atual. Um aplicativo de monitoramento DDE pode usar essa estrutura para monitorar erros retornados pelas funções da Biblioteca de Gerenciamento DDE.
MONHSZSTRUCT Contém informações sobre um identificador de cadeia de caracteres DDE. Um aplicativo de monitoramento DDE pode usar essa estrutura ao monitorar a atividade do componente gerenciador de cadeias de caracteres da Biblioteca de Gerenciamento DDE.
MONLINKSTRUCT Contém informações sobre um loop de aconselhamento DDE. Um aplicativo de monitoramento DDE pode usar essa estrutura para obter informações sobre um loop de aconselhamento iniciado ou encerrado.
MONMSGSTRUCT Contém informações sobre uma mensagem DDE. Um aplicativo de monitoramento DDE pode usar essa estrutura para obter informações sobre uma mensagem DDE que foi enviada ou postada.