Compartilhar via


XTYP_REQUEST transação

Um cliente usa a transação XTYP_REQUEST para solicitar dados de um servidor. Uma função de retorno de chamada de servidor DDE (Troca Dinâmica de Dados), DdeCallback, recebe essa transação quando um cliente especifica XTYP_REQUEST na função DdeClientTransaction .

#define     XCLASS_DATA              0x2000
#define     XTYP_REQUEST            (0x00B0 | XCLASS_DATA          )

Parâmetros

Utype

O tipo de transação.

uFmt

O formato no qual o servidor deve enviar dados 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.

hdata

Não usado.

dwData1

Não usado.

dwData2

Não usado.

Valor retornado

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

Comentários

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

Se responder a essa transação exigir processamento longo, o servidor poderá retornar o código de retorno CBR_BLOCK para suspender transações futuras na conversa atual e, em seguida, processar a transação de forma assíncrona. Quando o servidor for concluído e os dados estiverem prontos para serem passados para o cliente, o servidor poderá chamar a função DdeEnableCallback para retomar a conversa.

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

DdeCreateDataHandle

DdeEnableCallback

DdeInitialize

Conceitual

Biblioteca de Gerenciamento de Troca dinâmica de dados