transaction XTYP_ADVREQ

La transaction XTYP_ADVREQ informe le serveur qu’une transaction d’avis est en attente sur la paire nom de rubrique et nom d’élément spécifiée et que les données correspondant au nom de la rubrique et à la paire nom d’élément ont changé. Le système envoie cette transaction à la fonction de rappel Dynamic Data Exchange (DDE), DdeCallback, après que le serveur a appelé la fonction DdePostAdvise.

#define     XCLASS_DATA              0x2000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_ADVREQ             (0x0020 | XCLASS_DATA | XTYPF_NOBLOCK )

Paramètres

uType

Type de transaction.

uFmt

Format dans lequel les données doivent être envoyées au client.

hconv

Handle de la conversation.

hsz1

Handle du nom de la rubrique.

hsz2

Handle du nom de l’élément qui a changé.

hdata

Non utilisé.

dwData1

Nombre, dans le mot de faible ordre, de XTYP_ADVREQ transactions qui restent à traiter sur la même rubrique, élément et nom de format défini dans le contexte de l’appel actuel à la fonction DdePostAdvise . Le nombre est égal à zéro si la transaction XTYP_ADVREQ actuelle est la dernière. Un serveur peut utiliser ce nombre pour déterminer s’il faut créer un handle de données HDATA_APPOWNED aux données d’avis.

Le mot de faible ordre est défini sur CADV_LATEACK si le DDEML a émis la transaction XTYP_ADVREQ en raison d’un message DDE_ACK arrivant tardivement d’un client en cours d’exécution par le serveur.

Le mot à ordre élevé n’est pas utilisé.

dwData2

Non utilisé.

Valeur retournée

Le serveur doit d’abord appeler la fonction DdeCreateDataHandle pour créer un handle de données qui identifie les données modifiées, puis retourner le handle. Le serveur doit retourner NULL s’il n’est pas en mesure d’effectuer la transaction.

Notes

Un serveur ne peut pas bloquer ce type de transaction ; le code de retour CBR_BLOCK est ignoré.

Configuration requise

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 (include Windows.h)

Voir aussi

Référence

DdeCreateDataHandle

DdeInitialize

DdePostAdvise

Conceptuel

Bibliothèque de gestion des données dynamiques Exchange