DdePostAdvise-Funktion (ddeml.h)
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 |
Siehe auch
Konzept
Dynamic Data Exchange Management Library
Referenz