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 |
|
Confira também
-
Referência
-
Conceitual