transação XTYP_WILDCONNECT
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 |
|
Confira também
-
Referência
-
Conceitual