transação XTYP_ADVREQ

  • Artigo

A transação XTYP_ADVREQ informa ao servidor que uma transação de aviso está pendente no nome do tópico especificado e no par de nomes do item e que os dados correspondentes ao nome do tópico e ao par de nomes do item foram alterados. O sistema envia essa transação para a função de retorno de chamada DDE (Dynamic Data Exchange), DdeCallback, depois que o servidor chama a função DdePostAdvise .

#define     XCLASS_DATA              0x2000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_ADVREQ             (0x0020 | XCLASS_DATA | XTYPF_NOBLOCK )

Parâmetros

Utype

O tipo de transação.

uFmt

O formato no qual os dados devem ser enviados ao cliente.

hconv

Um identificador para a conversa.

hsz1

Um identificador para o nome do tópico.

hsz2

Um identificador para o nome do item que foi alterado.

hdata

Não usado.

dwData1

A contagem, na palavra de baixa ordem, de XTYP_ADVREQ transações que permanecem a ser processadas no mesmo tópico, item e nome de formato definido no contexto da chamada atual para a função DdePostAdvise . A contagem será zero se a transação de XTYP_ADVREQ atual for a última. Um servidor pode usar essa contagem para determinar se deseja criar um identificador de dados HDATA_APPOWNED para os dados de aconselhamento.

A palavra de baixa ordem será definida como CADV_LATEACK se o DDEML emitiu a transação XTYP_ADVREQ devido a uma mensagem de DDE_ACK de chegada tardia de um cliente que está sendo superado pelo servidor.

A palavra de alta ordem não é usada.

dwData2

Não usado.

Valor retornado

O servidor deve primeiro chamar a função DdeCreateDataHandle para criar um identificador de dados que identifique os dados alterados e, em seguida, retorne o identificador. O servidor deverá retornar NULL se não for possível concluir a transação.

Comentários

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

DdeCreateDataHandle

DdeInitialize

DdePostAdvise

Conceitual

Biblioteca de Gerenciamento dinâmico do Data Exchange