DdeNameService-Funktion (ddeml.h)

Artikel
08/23/2023

Registriert oder hebt die Registrierung der Dienstnamen auf, die von einem DDE-Server (Dynamic Data Exchange) unterstützt werden. Diese Funktion bewirkt, dass das System XTYP_REGISTER oder XTYP_UNREGISTER Transaktionen an andere ausgeführte DDEML-Clientanwendungen ( Dynamic Data Exchange Management Library ) sendet.

Syntax

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

Parameter

[in] idInst

Art: DWORD

Die Anwendung instance Bezeichner, der durch einen vorherigen Aufruf der Funktion DdeInitialize abgerufen wurde.

[in, optional] hsz1

Typ: HSZ

Ein Handle für die Zeichenfolge, das den Dienstnamen angibt, den der Server registriert oder die Registrierung auf hebt. Eine Anwendung, die die Registrierung aller Dienstnamen aufhebt, sollte diesen Parameter auf 0L festlegen.

[in, optional] hsz2

Typ: HSZ

Reserviert; sollte auf 0L festgelegt werden.

[in] afCmd

Typ: UINT

Die Dienstnamenoptionen. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
DNS_REGISTER 0x0001	Registriert den Fehlercodedienstnamen.
DNS_UNREGISTER 0x0002	Hebt die Registrierung des Fehlercodedienstnamens auf. Wenn der hsz1-Parameter 0L ist, werden alle vom Server registrierten Dienstnamen nicht registriert.
DNS_FILTERON 0x0004	Aktiviert die Filterung der Dienstnameninitiierung. Der Filter verhindert, dass ein Server XTYP_CONNECT Transaktionen für Dienstnamen empfängt, die er nicht registriert hat. Dies ist die Standardeinstellung für diesen Filter. Wenn eine Serveranwendung keine Dienstnamen registriert, kann die Anwendung keine XTYP_WILDCONNECT Transaktionen empfangen.
DNS_FILTEROFF 0x0008	Deaktiviert die Filterung der Dienstnameninitiierung. Wenn dieses Flag angegeben ist, empfängt der Server unabhängig vom Dienstnamen eine XTYP_CONNECT Transaktion, wenn eine andere DDE-Anwendung die DdeConnect-Funktion aufruft.

Rückgabewert

Typ: HDDEDATA

Wenn die Funktion erfolgreich ist, wird ein Wert ungleich null zurückgegeben. Dieser Wert ist kein wahrer HDDEDATA-Wert , sondern lediglich ein boolescher Erfolgsindikator. Die Funktion ist typisiert HDDEDATA , um eine mögliche zukünftige Erweiterung der Funktion und einen komplexeren Rückgabewert zu ermöglichen.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0L.

Die DdeGetLastError-Funktion kann verwendet werden, um den Fehlercode abzurufen, der einer der folgenden Werte sein kann:

Hinweise

Der durch den hsz1-Parameter identifizierte Dienstname sollte ein Basisname sein (d. h. der Name sollte keine instance spezifischen Informationen enthalten). Das System generiert einen instance spezifischen Namen und sendet ihn zusammen mit dem Basisnamen während der XTYP_REGISTER und XTYP_UNREGISTER Transaktionen. Die empfangenden Anwendungen können dann eine Verbindung mit der jeweiligen Anwendung instance herstellen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ddeml.h (Windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll