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