Partilhar via

Biblioteca de Gerenciamento de Intercâmbio de Dados Dinâmico

O intercâmbio dinâmico de dados (DDE) é uma forma de comunicação entre processos que utiliza memória partilhada para trocar dados entre aplicações. Os aplicativos podem usar DDE para transferências de dados únicas e para intercâmbios contínuos e atualização de dados.

Nesta secção

Designação Descrição
Sobre o DDEML Discute a troca dinâmica de dados.
Conceitos Básicos Discute conceitos-chave relativos ao intercâmbio dinâmico de dados.
Gestão de Conversação Discute conversas entre um cliente e um servidor.
de Gestão de Dados Discute como os objetos de memória passam dados de um aplicativo para outro.
Monitoramento de Aplicações Discute como os elementos da Biblioteca de Gerenciamento do Intercâmbio de Dados Dinâmicos podem ser usados para criar um aplicativo que monitora a atividade de troca de dados dinâmicos no sistema.
Serviço de Nomes Discute como a Biblioteca de Gerenciamento do Intercâmbio de Dados Dinâmicos possibilita que um aplicativo de servidor registre os nomes de serviço aos quais oferece suporte.
Gestão de Transações Discute como um cliente pode enviar transações para obter dados e serviços do servidor.
de referência DDEML Contém a referência da API.

Funções DDEML

Designação 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 desde o início do objeto. Se novos dados se sobrepõem a dados já no objeto, os novos dados sobrescrevem os dados antigos nos bytes onde ocorre a sobreposição. O conteúdo dos 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). Processa transações DDE. O tipo de 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ópicos. Se existir mais de um desses servidores, o sistema seleciona apenas um.
DdeConnectList Estabelece uma conversa com todos os aplicativos de servidor que oferecem suporte ao nome de serviço especificado e ao par de nomes de tópicos. Um aplicativo também pode usar essa função para obter uma lista de identificadores de conversação 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 passagem 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).
DdeDisconnect Encerra uma conversa iniciada pelo DdeConnect ou função de 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 Cobra taxas de 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 na Biblioteca de Gerenciamento do Intercâmbio de Dados Dinâmicos (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. Esta 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 estruturaCONVINFO retornada pela funçãoDdeQueryConvInfo.
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 aviso ativo sobre o tópico e o 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.
DdeReconnect Permite que um aplicativo DDEML (Dynamic Data Exchange Management Library) 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

Designação Descrição
XTYP_ADVDATA Informa o 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 aviso com um servidor.
XTYP_ADVREQ Informa o servidor que uma transação de aviso está pendente no nome do tópico especificado e no par de nomes de item e que os dados correspondentes ao nome do tópico e ao par de nomes 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çãoDdePostAdvise .
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çãoDdeClientTransaction.
XTYP_ADVSTOP Um cliente usa a transação XTYP_ADVSTOP para encerrar um loop de aviso 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çãoDdeClientTransaction.
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 suporta (e um nome de tópico que não é NULL ) em uma chamada para a funçãoDdeConnect.
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 esta transação como resultado de uma transação anterior XTYP_CONNECT ou XTYP_WILDCONNECT.
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çãoDdeClientTransaction.
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çãoDdeInitialize.
XTYP_POKE Um cliente usa a transação XTYP_POKE para enviar dados não solicitados para o servidor. Uma função de retorno de chamada do servidor DDE, DdeCallback , recebe essa transação quando um cliente especifica XTYP_POKE na funçãoDdeClientTransaction.
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 suporta o 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çãoDdeClientTransaction do.
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 suporta o 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 do serviço especificado e ao nome do tópico. 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 NULL, um nome de tópico NULL ou ambos em uma chamada para a função DdeConnect ou função 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çãoDdeClientTransaction, é concluída.

Estruturas DDEML

Designação Descrição
CONVCONTEXT Contém informações fornecidas por um aplicativo cliente DDE. As informações são úteis para conversas DDE especializadas ou em vários 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 utilizada por uma aplicação de monitorização 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 aviso DDE. Um aplicativo de monitoramento DDE pode usar essa estrutura para obter informações sobre um loop de aviso que foi iniciado ou terminado.
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.
  • Last updated on