transação XTYP_WILDCONNECT

  • Artigo

Permite que um cliente estabeleça uma conversa em cada um dos pares de nome de serviço e nome do tópico do servidor que correspondam ao nome do serviço e ao nome do tópico especificados. Uma função de retorno de chamada de servidor DDE (Dynamic Data Exchange), 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 .

#define     XCLASS_DATA              0x2000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_WILDCONNECT        (0x00E0 | XCLASS_DATA | 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. Se esse parâmetro for NULL, o cliente solicitará uma conversa sobre todos os nomes de tópicos compatíveis com o servidor.

hsz2

Um identificador para o nome do serviço. Se esse parâmetro for NULL, o cliente solicitará uma conversa em todos os nomes de serviço compatíveis com o servidor.

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á definido como 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

O servidor deve retornar um identificador de dados que identifique uma matriz de estruturas HSZPAIR . A matriz deve conter uma estrutura para cada par nome do serviço e nome do tópico que corresponde ao par nome do serviço e nome do tópico solicitado pelo cliente. A matriz deve ser encerrada por um identificador de cadeia de caracteres NULL . O sistema envia a transação XTYP_CONNECT_CONFIRM para o servidor para confirmar cada conversa e passar os identificadores de conversa para o servidor. O servidor não receberá essas confirmações se tiver especificado o sinalizador CBF_SKIP_CONNECT_CONFIRMS na função DdeInitialize .

O servidor deve retornar NULL para recusar a transação XTYP_WILDCONNECT .

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

HSZPAIR

Conceitual

Biblioteca de Gerenciamento dinâmico do Data Exchange