Fonction de rappel PFNCALLBACK (ddeml.h)

Article
08/23/2023

Fonction de rappel définie par l’application utilisée avec les fonctions DDEML ( Dynamic Data Exchange Management Library ). Il traite les transactions DDE (Dynamic Data Exchange). Le type PFNCALLBACK définit un pointeur vers cette fonction de rappel. DdeCallback est un espace réservé pour le nom de fonction défini par l’application.

Syntaxe

PFNCALLBACK Pfncallback;

HDDEDATA Pfncallback(
  [in] UINT wType,
  [in] UINT wFmt,
  [in] HCONV hConv,
  [in] HSZ hsz1,
  [in] HSZ hsz2,
  [in] HDDEDATA hData,
  [in] ULONG_PTR dwData1,
  [in] ULONG_PTR dwData2
)
{...}

Paramètres

[in] wType

Type : UINT

Type de la transaction actuelle. Ce paramètre se compose d’une combinaison d’indicateurs de classe de transaction et d’indicateurs de type de transaction. Le tableau suivant décrit chacune des classes de transactions et fournit une liste des types de transactions dans chaque classe. Pour plus d’informations sur un type de transaction spécifique, consultez la description individuelle de ce type dans Remarques.

[in] wFmt

Type : UINT

Format dans lequel les données sont envoyées ou reçues.

[in] hConv

Type : HCONV

Handle de la conversation associée à la transaction actuelle.

[in] hsz1

Type : HSZ

Handle d’une chaîne. La signification de ce paramètre dépend du type de la transaction actuelle. Pour connaître la signification de ce paramètre, consultez la description du type de transaction dans Remarques.

[in] hsz2

Type : HSZ

[in] hData

Type : HDDEDATA

Handle pour les données DDE. La signification de ce paramètre dépend du type de la transaction actuelle. Pour connaître la signification de ce paramètre, consultez la description du type de transaction dans Remarques.

[in] dwData1

Type : ULONG_PTR

Données spécifiques à la transaction. Pour connaître la signification de ce paramètre, consultez la description du type de transaction dans Remarques.

[in] dwData2

Type : ULONG_PTR

Données spécifiques à la transaction. Pour connaître la signification de ce paramètre, consultez la description du type de transaction dans Remarques.

Valeur retournée

Type : HDDEDATA

La valeur de retour dépend de la classe de transaction. Pour plus d’informations sur les valeurs de retour, consultez les descriptions des types de transactions individuels.

Notes

XCLASS_BOOL

Une fonction de rappel DDE doit retourner TRUE ou FALSE lorsqu’elle termine le traitement d’une transaction qui appartient à cette classe. La classe de transaction XCLASS_BOOL se compose des types suivants :

XCLASS_DATA

Une fonction de rappel DDE doit retourner un handle DDE, le code de retour CBR_BLOCK ou NULL lorsqu’il termine le traitement d’une transaction qui appartient à cette classe. La classe de transaction XCLASS_DATA se compose des types suivants :

XCLASS_FLAGS

Une fonction de rappel DDE doit retourner DDE_FACK, DDE_FBUSY ou DDE_FNOTPROCESSED lorsqu’elle termine le traitement d’une transaction qui appartient à cette classe. La classe de transaction XCLASS_FLAGS se compose des types suivants :

XCLASS_NOTIFICATION

Les types de transactions qui appartiennent à cette classe sont à des fins de notification uniquement. La valeur de retour de la fonction de rappel est ignorée. La classe de transaction XCLASS_NOTIFICATION se compose des types suivants :

La fonction de rappel est appelée de manière asynchrone pour les transactions qui n’impliquent pas la création ou l’arrêt de conversations. Une application qui n’accepte pas fréquemment les messages entrants aura des performances DDE réduites, car la bibliothèque de gestion DDEML (Dynamic Data Exchange Management Library) utilise des messages pour lancer des transactions.

Une application doit inscrire la fonction de rappel en spécifiant un pointeur vers la fonction dans un appel à la fonction DdeInitialize .

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ddeml.h (inclure Windows.h)

Voir aussi

Conceptuel

DdeEnableCallback

DdeInitialize

Bibliothèque de gestion Dynamic Data Exchange

Partager via