Partager via


DdeNameService, fonction (ddeml.h)

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

Voir aussi

Conceptuel

DdeConnect

DdeConnectList

DdeInitialize

Bibliothèque de gestion Dynamic Data Exchange

Référence

XTYP_REGISTER

XTYP_UNREGISTER