transação XTYP_CONNECT

Um cliente usa a transação XTYP_CONNECT para estabelecer uma conversa. Uma função de retorno de chamada do servidor DDE (Dynamic Data Exchange), DdeCallback, recebe essa transação quando um cliente especifica um nome de serviço compatível com o servidor (e um nome de tópico que não é NULL) em uma chamada para a função DdeConnect .

#define     XCLASS_BOOL              0x1000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_CONNECT            (0x0060 | XCLASS_BOOL | XTYPF_NOBLOCK)

Parâmetros

Utype

O tipo de transação.

uFmt

Não usado.

hconv

Não usado.

hsz1

Um identificador para o nome do tópico.

hsz2

Um identificador para o nome do serviço.

hdata

Não usado.

dwData1

Um ponteiro para uma estrutura CONVCONTEXT que contém informações de contexto para a conversa. Se o cliente não for um aplicativo DDEML, esse parâmetro será 0.

dwData2

Especifica se o cliente é a mesma instância de aplicativo que o servidor. Se o parâmetro for 1, o cliente será a mesma instância. Se o parâmetro for 0, o cliente será uma instância diferente.

Valor retornado

Uma função de retorno de chamada do servidor deve retornar TRUE para permitir que o cliente estabeleça uma conversa no nome do serviço especificado e no par de nomes do tópico, ou a função deve retornar FALSE para negar a conversa. Se a função de retorno de chamada retornar TRUE e uma conversa for estabelecida com êxito, o sistema passará o identificador de conversa para o servidor emitindo uma transação XTYP_CONNECT_CONFIRM para a função de retorno de chamada do servidor (a menos que o servidor tenha especificado o sinalizador CBF_SKIP_CONNECT_CONFIRMS na função DdeInitialize ).

Comentários

Essa transação será filtrada se o aplicativo de servidor tiver especificado o sinalizador CBF_FAIL_CONNECTIONS na função DdeInitialize .

Um servidor não pode bloquear esse tipo de transação; o código de retorno CBR_BLOCK é ignorado.

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]
Cabeçalho	Ddeml.h (inclua Windows.h)

Confira também

Referência

CONVCONTEXT

DdeConnect

DdeInitialize

Conceitual

Biblioteca de Gerenciamento dinâmico do Data Exchange