DdePostAdvise-Funktion (ddeml.h)

Artikel
08/23/2023

Bewirkt, dass das System eine XTYP_ADVREQ Transaktion an die DDE-Rückruffunktion (Dynamic Data Exchange) der aufrufenden (Server)-Anwendung für jeden Client mit einer aktiven Empfehlungsschleife für das angegebene Thema und Element sendet. Eine Serveranwendung sollte diese Funktion immer dann aufrufen, wenn sich die Daten, die dem Themennamen- oder Elementnamenpaar zugeordnet sind, ändern.

Syntax

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

Parameter

[in] idInst

Art: DWORD

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

[in] hszTopic

Typ: HSZ

Ein Handle für eine Zeichenfolge, die den Themennamen angibt. Um Benachrichtigungen für alle Themen mit aktiven Empfehlungsschleifen zu senden, kann eine Anwendung diesen Parameter auf 0L festlegen.

[in] hszItem

Typ: HSZ

Ein Handle für eine Zeichenfolge, die den Elementnamen angibt. Um Benachrichtigungen für alle Elemente mit aktiven Empfehlungsschleifen zu senden, kann eine Anwendung diesen Parameter auf 0L festlegen.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

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

Hinweise

Ein Server mit nicht aufzählbaren Themen oder Elementen sollte die Parameter hszTopic und hszItem auf NULL festlegen, damit das System Transaktionen für alle aktiven Ratgeberschleifen generiert. Die DDE-Rückruffunktion des Servers gibt NULL für alle Empfehlungsschleifen zurück, die nicht aktualisiert werden dürfen.

Wenn ein Server DdePostAdvise mit einem Themen-, Element- und Formatnamenssatz aufruft, der den Satz enthält, der derzeit in einem XTYP_ADVREQ Rückruf behandelt wird, kann es zu einem Stapelüberlauf führen.

Anforderungen

Anforderung	Wert
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