Função DdeConnect (ddeml.h)

Artigo
08/23/2023

Estabelece uma conversa com um aplicativo de servidor que dá suporte ao nome do serviço e ao par de nomes de tópico especificados. Se houver mais de um servidor desse tipo, o sistema selecionará apenas um.

Sintaxe

HCONV DdeConnect(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in, optional] PCONVCONTEXT pCC
);

Parâmetros

[in] idInst

Tipo: DWORD

O identificador de instância do aplicativo obtido por uma chamada anterior para a função DdeInitialize .

[in] hszService

Tipo: HSZ

Um identificador para a cadeia de caracteres que especifica o nome do serviço do aplicativo de servidor com o qual uma conversa deve ser estabelecida. Esse identificador deve ter sido criado por uma chamada anterior para a função DdeCreateStringHandle . Se esse parâmetro for 0L, uma conversa será estabelecida com qualquer servidor disponível.

[in] hszTopic

Tipo: HSZ

Um identificador para a cadeia de caracteres que especifica o nome do tópico no qual uma conversa deve ser estabelecida. Esse identificador deve ter sido criado por uma chamada anterior para DdeCreateStringHandle. Se esse parâmetro for 0L, uma conversa em qualquer tópico compatível com o servidor selecionado será estabelecida.

[in, optional] pCC

Tipo: PCONVCONTEXT

Um ponteiro para a estrutura CONVCONTEXT que contém informações de contexto de conversa. Se esse parâmetro for NULL, o servidor receberá a estrutura CONVCONTEXT padrão durante a transação XTYP_CONNECT ou XTYP_WILDCONNECT .

Retornar valor

Tipo: HCONV

Se a função for bem-sucedida, o valor retornado será o identificador para a conversa estabelecida.

Se a função falhar, o valor retornado será 0L.

A função DdeGetLastError pode ser usada para obter o código de erro, que pode ser um dos seguintes valores:

Comentários

O aplicativo cliente não pode fazer suposições sobre o servidor selecionado. Se um nome específico da instância for especificado no parâmetro hszService , uma conversa será estabelecida apenas com a instância especificada. Os nomes de serviço específicos da instância são passados para a função de retorno de chamada DDE (Troca Dinâmica de Dados) de um aplicativo durante as transações XTYP_REGISTER e XTYP_UNREGISTER .

Todos os membros da estrutura CONVCONTEXT padrão são definidos como zero, exceto cb, que especifica o tamanho da estrutura e iCodePage, que especifica CP_WINANSI (a página de código padrão) ou CP_WINUNICODE, dependendo se a versão ANSI ou Unicode da função DdeInitialize foi chamada pelo aplicativo cliente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ddeml.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll