DdePostAdvise, fonction (ddeml.h)

Article
02/29/2024

Entraîne l’envoi d’une transaction XTYP_ADVREQ à la fonction de rappel DDE (Dynamic Data Exchange) de l’application appelante (serveur) pour chaque client avec une boucle de conseil active sur la rubrique et l’élément spécifiés. Une application serveur doit appeler cette fonction chaque fois que les données associées au nom de la rubrique ou à la paire de noms d’élément changent.

Syntaxe

BOOL DdePostAdvise(
  [in] DWORD idInst,
  [in] HSZ   hszTopic,
  [in] HSZ   hszItem
);

Paramètres

[in] idInst

Type : DWORD

L’application instance identificateur obtenu par un appel précédent à la fonction DdeInitialize.

[in] hszTopic

Type : HSZ

Handle d’une chaîne qui spécifie le nom de la rubrique. Pour envoyer des notifications pour toutes les rubriques avec des boucles d’avis actives, une application peut définir ce paramètre sur 0L.

[in] hszItem

Type : HSZ

Handle d’une chaîne qui spécifie le nom de l’élément. Pour envoyer des notifications pour tous les éléments avec des boucles de conseil actives, une application peut définir ce paramètre sur 0L.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

La fonction DdeGetLastError peut être utilisée pour obtenir le code d’erreur, qui peut être l’une des valeurs suivantes :

Remarques

Un serveur qui n’a aucun nombre de rubriques ou d’éléments doit définir les paramètres hszTopic et hszItem sur NULL afin que le système génère des transactions pour toutes les boucles d’avis actives. La fonction de rappel DDE du serveur retourne NULL pour toutes les boucles d’avertissement qui ne doivent pas être mises à jour.

Si un serveur appelle DdePostAdvise avec un jeu de noms de rubrique, d’élément et de format qui inclut le jeu actuellement géré dans un rappel XTYP_ADVREQ , un dépassement de capacité de la pile peut en résulter.

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]
Plateforme cible	Windows
En-tête	ddeml.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll