Biblioteca de Gerenciamento do Dynamic Data Exchange

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.