PFNCALLBACK-Rückruffunktion (ddeml.h)

Eine anwendungsdefinierte Rückruffunktion, die mit den DDEML-Funktionen ( Dynamic Data Exchange Management Library ) verwendet wird. Es verarbeitet DDE-Transaktionen (Dynamic Data Exchange). Der PFNCALLBACK-Typ definiert einen Zeiger auf diese Rückruffunktion. DdeCallback ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

PFNCALLBACK Pfncallback;

HDDEDATA Pfncallback(
  [in] UINT wType,
  [in] UINT wFmt,
  [in] HCONV hConv,
  [in] HSZ hsz1,
  [in] HSZ hsz2,
  [in] HDDEDATA hData,
  [in] ULONG_PTR dwData1,
  [in] ULONG_PTR dwData2
)
{...}

Parameter

[in] wType

Typ: UINT

Der Typ der aktuellen Transaktion. Dieser Parameter besteht aus einer Kombination aus Transaktionsklassenflags und Transaktionstypflags. In der folgenden Tabelle werden die einzelnen Transaktionsklassen beschrieben und eine Liste der Transaktionstypen in jeder Klasse bereitgestellt. Informationen zu einem bestimmten Transaktionstyp finden Sie in der individuellen Beschreibung dieses Typs unter Hinweise.

[in] wFmt

Typ: UINT

Das Format, in dem Daten gesendet oder empfangen werden.

[in] hConv

Typ: HCONV

Ein Handle für die Unterhaltung, die der aktuellen Transaktion zugeordnet ist.

[in] hsz1

Typ: HSZ

Ein Handle für eine Zeichenfolge. Die Bedeutung dieses Parameters hängt vom Typ der aktuellen Transaktion ab. Die Bedeutung dieses Parameters finden Sie in der Beschreibung des Transaktionstyps unter Hinweise.

[in] hsz2

Typ: HSZ

Ein Handle für eine Zeichenfolge. Die Bedeutung dieses Parameters hängt vom Typ der aktuellen Transaktion ab. Die Bedeutung dieses Parameters finden Sie in der Beschreibung des Transaktionstyps unter Hinweise.

[in] hData

Typ: HDDEDATA

Ein Handle für DDE-Daten. Die Bedeutung dieses Parameters hängt vom Typ der aktuellen Transaktion ab. Die Bedeutung dieses Parameters finden Sie in der Beschreibung des Transaktionstyps unter Hinweise.

[in] dwData1

Typ: ULONG_PTR

Transaktionsspezifische Daten. Die Bedeutung dieses Parameters finden Sie in der Beschreibung des Transaktionstyps unter Hinweise.

[in] dwData2

Typ: ULONG_PTR

Transaktionsspezifische Daten. Die Bedeutung dieses Parameters finden Sie in der Beschreibung des Transaktionstyps unter Hinweise.

Rückgabewert

Typ: HDDEDATA

Der Rückgabewert hängt von der Transaktionsklasse ab. Weitere Informationen zu den Rückgabewerten finden Sie unter Beschreibungen der einzelnen Transaktionstypen.

Hinweise

XCLASS_BOOL

Eine DDE-Rückruffunktion sollte TRUE oder FALSE zurückgeben, wenn sie die Verarbeitung einer Transaktion abgeschlossen hat, die zu dieser Klasse gehört. Die XCLASS_BOOL Transaktionsklasse besteht aus den folgenden Typen:

XCLASS_DATA

Eine DDE-Rückruffunktion sollte ein DDE-Handle, den CBR_BLOCK Rückgabecode oder NULL zurückgeben, wenn sie die Verarbeitung einer Transaktion abgeschlossen hat, die zu dieser Klasse gehört. Die XCLASS_DATA Transaktionsklasse besteht aus den folgenden Typen:

XCLASS_FLAGS

Eine DDE-Rückruffunktion sollte DDE_FACK, DDE_FBUSY oder DDE_FNOTPROCESSED zurückgeben, wenn sie die Verarbeitung einer Transaktion abgeschlossen hat, die zu dieser Klasse gehört. Die XCLASS_FLAGS Transaktionsklasse besteht aus den folgenden Typen:

XCLASS_NOTIFICATION

Die Transaktionstypen, die zu dieser Klasse gehören, dienen nur zu Benachrichtigungszwecken. Der Rückgabewert der Rückruffunktion wird ignoriert. Die XCLASS_NOTIFICATION Transaktionsklasse besteht aus den folgenden Typen:

Die Rückruffunktion wird asynchron für Transaktionen aufgerufen, die keine Erstellung oder Beendigung von Unterhaltungen beinhalten. Eine Anwendung, die eingehende Nachrichten nicht häufig akzeptiert, weist eine verringerte DDE-Leistung auf, da die DDEML (Dynamic Data Exchange Management Library) Nachrichten verwendet, um Transaktionen zu initiieren.

Eine Anwendung muss die Rückruffunktion registrieren, indem sie einen Zeiger auf die Funktion in einem Aufruf der DdeInitialize-Funktion angibt.

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 (Einschließen von Windows.h)

Siehe auch

Konzept

DdeEnableCallback

DdeInitialize

Verwaltungsbibliothek für dynamische Daten