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