transaction XTYP_ADVSTART

Un client utilise la transaction XTYP_ADVSTART pour établir une boucle de conseil avec un serveur. Une fonction de rappel de serveur DDE (Dynamic Data Exchange), DdeCallback, reçoit cette transaction lorsqu’un client spécifie XTYP_ADVSTART comme paramètre wType de la fonction DdeClientTransaction .

#define     XCLASS_BOOL              0x1000
#define     XTYP_ADVSTART           (0x0030 | XCLASS_BOOL          )

Paramètres

uType

Type de transaction.

uFmt

Format de données demandé par le client.

hconv

Handle de la conversation.

hsz1

Handle du nom de la rubrique.

hsz2

Handle du nom de l’élément.

hdata

Non utilisé.

dwData1

Non utilisé.

dwData2

Non utilisé.

Valeur retournée

Une fonction de rappel de serveur doit retourner TRUE pour autoriser une boucle d’avis sur la paire nom de rubrique et nom d’élément spécifiée, ou FALSE pour refuser la boucle d’avis. Si la fonction de rappel retourne TRUE, tous les appels ultérieurs à la fonction DdePostAdvise par le serveur sur la même paire nom de rubrique et nom d’élément entraînent l’envoi par le système de XTYP_ADVREQ transactions au serveur.

Notes

Si un client demande une boucle d’avis sur un nom de rubrique, un nom d’élément et un format de données pour une boucle d’avis déjà établie, la bibliothèque de gestion DDEML (Dynamic Data Exchange Management Library) ne crée pas de boucle de conseil en double, mais modifie plutôt les indicateurs de boucle de conseil (XTYPF_ACKREQ et XTYPF_NODATA) pour qu’ils correspondent à la dernière requête.

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

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

Voir aussi

Référence

DdeClientTransaction

DdeInitialize

DdePostAdvise

Conceptuel

Bibliothèque de gestion Dynamic Data Exchange