transação XTYP_EXECUTE

  • Artigo

Um cliente usa a transação XTYP_EXECUTE para enviar uma cadeia de caracteres de comando para o servidor. Uma função de retorno de chamada do servidor DDE (Dynamic Data Exchange), DdeCallback, recebe essa transação quando um cliente especifica XTYP_EXECUTE na função DdeClientTransaction .

#define     XCLASS_FLAGS             0x4000
#define     XTYP_EXECUTE            (0x0050 | XCLASS_FLAGS         )

Parâmetros

Utype

O tipo de transação.

uFmt

Não usado.

hconv

Um identificador para a conversa.

hsz1

Um identificador para o nome do tópico.

hsz2

Não usado.

hdata

Um identificador para a cadeia de caracteres de comando.

dwData1

Não usado.

dwData2

Não usado.

Valor retornado

Uma função de retorno de chamada de servidor deverá retornar DDE_FACK se processar essa transação, DDE_FBUSY se ela estiver muito ocupada para processar essa transação ou DDE_FNOTPROCESSED se rejeitar essa transação.

Comentários

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

Um aplicativo deve liberar o identificador de dados obtido durante essa transação. No entanto, um aplicativo deve copiar a cadeia de caracteres de comando associada ao identificador de dados se o aplicativo precisar processar a cadeia de caracteres após o retorno da função de retorno de chamada. Um aplicativo pode usar a função DdeGetData para copiar os dados.

Como a maioria dos aplicativos cliente espera que um aplicativo de servidor execute uma transação XTYP_EXECUTE de forma síncrona, um servidor deve tentar executar todo o processamento da transação XTYP_EXECUTE dentro da função de retorno de chamada DDE ou retornando o código de retorno CBR_BLOCK . Se o parâmetro hdata for um comando que instrua o servidor a terminar, o servidor deverá fazê-lo depois de processar a transação XTYP_EXECUTE .

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

DdeGetData

DdeInitialize

Conceitual

Biblioteca de Gerenciamento dinâmico do Data Exchange