DdeNameService, fonction (ddeml.h)

Article
08/23/2023

Inscrit ou annule l’inscription des noms de service pris en charge par un serveur DDE (Dynamic Data Exchange). Cette fonction amène le système à envoyer des transactions XTYP_REGISTER ou XTYP_UNREGISTER à d’autres applications clientes DDEML ( Dynamic Data Exchange Management Library ) en cours d’exécution.

Syntaxe

HDDEDATA DdeNameService(
  [in]           DWORD idInst,
  [in, optional] HSZ   hsz1,
  [in, optional] HSZ   hsz2,
  [in]           UINT  afCmd
);

Paramètres

[in] idInst

Type : DWORD

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

[in, optional] hsz1

Type : HSZ

Handle de la chaîne qui spécifie le nom de service que le serveur inscrit ou annule l’inscription. Une application qui annule l’inscription de tous ses noms de service doit définir ce paramètre sur 0L.

[in, optional] hsz2

Type : HSZ

Réservés au; doit être défini sur 0L.

[in] afCmd

Type : UINT

Options de nom de service. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
DNS_REGISTER 0x0001	Inscrit le nom du service de code d’erreur.
DNS_UNREGISTER 0x0002	Annule l’inscription du nom du service de code d’erreur. Si le paramètre hsz1 a la valeur 0L, tous les noms de service inscrits par le serveur seront désinscrits.
DNS_FILTERON 0x0004	Active le filtrage d’initiation de nom de service. Le filtre empêche un serveur de recevoir des transactions XTYP_CONNECT pour des noms de service qu’il n’a pas inscrits. Il s’agit du paramètre par défaut pour ce filtre. Si une application serveur n’inscrit aucun nom de service, l’application ne peut pas recevoir de transactions XTYP_WILDCONNECT .
DNS_FILTEROFF 0x0008	Désactive le filtrage d’initiation de nom de service. Si cet indicateur est spécifié, le serveur reçoit une transaction XTYP_CONNECT chaque fois qu’une autre application DDE appelle la fonction DdeConnect , quel que soit le nom du service.

Valeur retournée

Type : HDDEDATA

Si la fonction réussit, elle retourne une valeur différente de zéro. Cette valeur n’est pas une véritable valeur HDDEDATA , mais simplement un indicateur booléen de réussite. La fonction est typée HDDEDATA pour permettre une expansion future possible de la fonction et une valeur de retour plus sophistiquée.

Si la fonction échoue, la valeur de retour est 0L.

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

Notes

Le nom du service identifié par le paramètre hsz1 doit être un nom de base (autrement dit, le nom ne doit contenir aucune information spécifique à instance). Le système génère un nom spécifique au instance et l’envoie avec le nom de base pendant les transactions XTYP_REGISTER et XTYP_UNREGISTER. Les applications réceptrices peuvent ensuite se connecter à l’application instance spécifique.

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)
Bibliothèque	User32.lib
DLL	User32.dll