Partager via


XTYP_EXECUTE transaction

Un client utilise la transaction XTYP_EXECUTE pour envoyer une chaîne de commande au serveur. Une fonction de rappel de serveur DDE (Dynamic Data Exchange), DdeCallback, reçoit cette transaction lorsqu’un client spécifie XTYP_EXECUTE dans la fonction DdeClientTransaction .

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

Paramètres

uType

Type de transaction.

uFmt

Non utilisé.

hconv

Handle de la conversation.

hsz1

Handle du nom de la rubrique.

hsz2

Non utilisé.

hdata

Handle de la chaîne de commande.

dwData1

Non utilisé.

dwData2

Non utilisé.

Valeur retournée

Une fonction de rappel de serveur doit retourner DDE_FACK si elle traite cette transaction, DDE_FBUSY si elle est trop occupée pour traiter cette transaction, ou DDE_FNOTPROCESSED si elle rejette cette transaction.

Notes

Cette transaction est filtrée si l’application serveur a spécifié l’indicateur CBF_FAIL_EXECUTES dans la fonction DdeInitialize .

Une application doit libérer le handle de données obtenu pendant cette transaction. Toutefois, une application doit copier la chaîne de commande associée au handle de données si l’application doit traiter la chaîne après le retour de la fonction de rappel. Une application peut utiliser la fonction DdeGetData pour copier les données.

Étant donné que la plupart des applications clientes s’attendent à ce qu’une application serveur effectue une transaction XTYP_EXECUTE de manière synchrone, un serveur doit tenter d’effectuer tout le traitement de la transaction XTYP_EXECUTE à partir de la fonction de rappel DDE ou en retournant le code de retour CBR_BLOCK . Si le paramètre hdata est une commande qui indique au serveur de s’arrêter, il doit le faire après avoir traité la transaction XTYP_EXECUTE .

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
En-tête
Ddeml.h (inclure Windows.h)

Voir aussi

Référence

DdeClientTransaction

DdeGetData

DdeInitialize

Conceptuel

Bibliothèque de gestion Dynamic Data Exchange