Compartilhar via


transação XTYP_ADVSTART

Um cliente usa a transação XTYP_ADVSTART para estabelecer um loop de aconselhamento com um servidor. Uma função de retorno de chamada de servidor DDE (Dynamic Data Exchange), DdeCallback, recebe essa transação quando um cliente especifica XTYP_ADVSTART como o parâmetro wType da função DdeClientTransaction .

#define     XCLASS_BOOL              0x1000
#define     XTYP_ADVSTART           (0x0030 | XCLASS_BOOL          )

Parâmetros

Utype

O tipo de transação.

uFmt

O formato de dados solicitado pelo cliente.

hconv

Um identificador para a conversa.

hsz1

Um identificador para o nome do tópico.

hsz2

Um identificador para o nome do item.

hdata

Não usado.

dwData1

Não usado.

dwData2

Não usado.

Valor retornado

Uma função de retorno de chamada do servidor deve retornar TRUE para permitir um loop de aconselhamento no nome do tópico especificado e no par de nomes do item ou FALSE para negar o loop de aconselhamento. Se a função de retorno de chamada retornar TRUE, todas as chamadas subsequentes para a função DdePostAdvise pelo servidor no mesmo nome de tópico e par de nomes de item farão com que o sistema envie transações XTYP_ADVREQ para o servidor.

Comentários

Se um cliente solicitar um loop de aconselhamento em um nome de tópico, nome do item e formato de dados para um loop de aconselhamento já estabelecido, a DDEML (Biblioteca de Gerenciamento do Exchange de Dados Dinâmico) não criará um loop de aconselhamento duplicado, mas alterará os sinalizadores de loop de aconselhamento (XTYPF_ACKREQ e XTYPF_NODATA) para corresponder à solicitação mais recente.

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

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

DdeClientTransaction

DdeInitialize

DdePostAdvise

Conceitual

Biblioteca de Gerenciamento dinâmico do Data Exchange