DdeInitializeA-Funktion (ddeml.h)

Artikel
03/01/2024

Registriert eine Anwendung bei der Dynamic Data Exchange Management Library (DDEML). Eine Anwendung muss diese Funktion aufrufen, bevor sie eine andere DDEML-Funktion (Dynamic Data Exchange Management Library) aufruft.

Syntax

UINT DdeInitializeA(
  [in, out] LPDWORD     pidInst,
  [in]      PFNCALLBACK pfnCallback,
  [in]      DWORD       afCmd,
            DWORD       ulRes
);

Parameter

[in, out] pidInst

Typ: LPDWORD

Die Anwendung instance Bezeichners. Bei der Initialisierung sollte dieser Parameter auf 0 zeigen. Wenn die Funktion erfolgreich ist, verweist dieser Parameter auf den instance Bezeichner für die Anwendung. Dieser Wert sollte als idInst-Parameter in allen anderen DDEML-Funktionen übergeben werden, die ihn benötigen. Wenn eine Anwendung mehrere Instanzen der DDEML-DLL (Dynamic Link Library) verwendet, sollte die Anwendung für jede instance eine andere Rückruffunktion bereitstellen.

Wenn pidInst auf einen Nonzero-Wert verweist, wird die erneute Initialisierung der DDEML impliziert. In diesem Fall muss pidInst auf einen gültigen Anwendungs-instance-Bezeichner verweisen.

[in] pfnCallback

Typ: PFNCALLBACK

Ein Zeiger auf die anwendungsdefinierte DDE-Rückruffunktion. Diese Funktion verarbeitet vom System gesendete DDE-Transaktionen. Weitere Informationen finden Sie in der Rückruffunktion DdeCallback .

[in] afCmd

Art: DWORD

Eine Reihe von APPCMD_-, CBF_- und MF_ -Flags. Die APPCMD_ -Flags bieten spezielle Anweisungen für DdeInitialize. Die CBF_ -Flags geben Filter an, die verhindern, dass bestimmte Transaktionstypen die Rückruffunktion erreichen. Die MF_ Flags geben die Typen der DDE-Aktivität an, die eine DDE-Überwachungsanwendung überwacht. Die Verwendung dieser Flags verbessert die Leistung einer DDE-Anwendung, indem unnötige Aufrufe der Rückruffunktion beseitigt werden.

Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert	Bedeutung
APPCLASS_MONITOR 0x00000001L	Ermöglicht es der Anwendung, die DDE-Aktivität im System zu überwachen. Dieses Flag ist für die Verwendung durch DDE-Überwachungsanwendungen vorgesehen. Die Anwendung gibt die Zu überwachenden DDE-Aktivitätstypen an, indem ein oder mehrere Monitorflags mit dem APPCLASS_MONITOR-Flags kombiniert werden. Ausführliche Informationen finden Sie im folgenden Abschnitt mit den Anmerkungen.
APPCLASS_STANDARD 0x00000000L	Registriert die Anwendung als DDEML-Standardanwendung (ohne Überwachung).
APPCMD_CLIENTONLY 0x00000010L	Verhindert, dass die Anwendung zu einem Server in einer DDE-Unterhaltung wird. Die Anwendung kann nur ein Client sein. Dieses Flag reduziert den Ressourcenverbrauch durch die DDEML. Sie enthält die Funktionalität des flags CBF_FAIL_ALLSVRXACTIONS .
APPCMD_FILTERINITS 0x00000020L	Verhindert, dass die DDEML XTYP_CONNECT und XTYP_WILDCONNECT Transaktionen an die Anwendung sendet, bis die Anwendung ihre Zeichenfolgenhandles erstellt und ihre Dienstnamen registriert hat oder die Filterung durch einen nachfolgenden Aufruf der DdeNameService - oder DdeInitialize-Funktion deaktiviert hat. Dieses Flag ist immer wirksam, wenn eine Anwendung DdeInitialize zum ersten Mal aufruft, unabhängig davon, ob die Anwendung das Flag angibt. Bei nachfolgenden Aufrufen von DdeInitialize werden die Dienstnamenfilter der Anwendung deaktiviert, wenn Sie dieses Flag nicht angeben, sondern die Dienstnamenfilter der Anwendung aktivieren.
CBF_FAIL_ALLSVRXACTIONS 0x0003f000	Verhindert, dass die Rückruffunktion Servertransaktionen empfängt. Das System gibt DDE_FNOTPROCESSED an jeden Client zurück, der eine Transaktion an diese Anwendung sendet. Dieses Flag entspricht der Kombination aller CBF_FAIL_ Flags.
CBF_FAIL_ADVISES 0x00004000	Verhindert, dass die Rückruffunktion XTYP_ADVSTART - und XTYP_ADVSTOP-Transaktionen empfängt. Das System gibt DDE_FNOTPROCESSED an jeden Client zurück, der eine XTYP_ADVSTART - oder XTYP_ADVSTOP-Transaktion an den Server sendet.
CBF_FAIL_CONNECTIONS 0x00002000	Verhindert, dass die Rückruffunktion XTYP_CONNECT - und XTYP_WILDCONNECT-Transaktionen empfängt.
CBF_FAIL_EXECUTES 0x00008000	Verhindert, dass die Rückruffunktion XTYP_EXECUTE Transaktionen empfängt. Das System gibt DDE_FNOTPROCESSED an einen Client zurück, der eine XTYP_EXECUTE Transaktion an den Server sendet.
CBF_FAIL_POKES 0x00010000	Verhindert, dass die Rückruffunktion XTYP_POKE Transaktionen empfängt. Das System gibt DDE_FNOTPROCESSED an einen Client zurück, der eine XTYP_POKE Transaktion an den Server sendet.
CBF_FAIL_REQUESTS 0x00020000	Verhindert, dass die Rückruffunktion XTYP_REQUEST Transaktionen empfängt. Das System gibt DDE_FNOTPROCESSED an einen Client zurück, der eine XTYP_REQUEST Transaktion an den Server sendet.
CBF_FAIL_SELFCONNECTIONS 0x00001000	Verhindert, dass die Rückruffunktion XTYP_CONNECT Transaktionen aus dem eigenen instance der Anwendung empfängt. Dieses Flag verhindert, dass eine Anwendung eine DDE-Unterhaltung mit einer eigenen instance. Eine Anwendung sollte dieses Flag verwenden, wenn sie mit anderen Instanzen von sich selbst, aber nicht mit sich selbst kommunizieren muss.
CBF_SKIP_ALLNOTIFICATIONS 0x003c0000	Verhindert, dass die Rückruffunktion Benachrichtigungen empfängt. Dieses Flag entspricht der Kombination aller CBF_SKIP_ Flags.
CBF_SKIP_CONNECT_CONFIRMS 0x00040000	Verhindert, dass die Rückruffunktion XTYP_CONNECT_CONFIRM Benachrichtigungen empfängt.
CBF_SKIP_DISCONNECTS 0x00200000	Verhindert, dass die Rückruffunktion XTYP_DISCONNECT Benachrichtigungen empfängt.
CBF_SKIP_REGISTRATIONS 0x00080000	Verhindert, dass die Rückruffunktion XTYP_REGISTER Benachrichtigungen empfängt.
CBF_SKIP_UNREGISTRATIONS 0x00100000	Verhindert, dass die Rückruffunktion XTYP_UNREGISTER Benachrichtigungen empfängt.
MF_CALLBACKS 0x08000000	Benachrichtigt die Rückruffunktion, wenn eine Transaktion an eine DDE-Rückruffunktion im System gesendet wird.
MF_CONV 0x40000000	Benachrichtigt die Rückruffunktion, wenn eine Konversation eingerichtet oder beendet wird.
MF_ERRORS 0x10000000	Benachrichtigt die Rückruffunktion, wenn ein DDE-Fehler auftritt.
MF_HSZ_INFO 0x01000000	Benachrichtigt die Rückruffunktion, wenn eine DDE-Anwendung die Nutzungsanzahl eines Zeichenfolgenhandles erstellt, freigibt oder erhöht oder wenn ein Zeichenfolgenhandle als Ergebnis eines Aufrufs der DdeUninitialize-Funktion freigegeben wird.
MF_LINKS 0x20000000	Benachrichtigt die Rückruffunktion, wenn eine Empfehlungsschleife gestartet oder beendet wird.
MF_POSTMSGS 0x04000000	Benachrichtigt die Rückruffunktion, wenn das System oder eine Anwendung eine DDE-Nachricht sendet.
MF_SENDMSGS 0x02000000	Benachrichtigt die Rückruffunktion, wenn das System oder eine Anwendung eine DDE-Nachricht sendet.

ulRes

Art: DWORD

Reserviert; muss auf 0 (null) festgelegt werden.

Rückgabewert

Typ: UINT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert DMLERR_NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Werte:

Hinweise

Eine Anwendung, die mehrere Instanzen der DDEML verwendet, darf DDEML-Objekte nicht zwischen Instanzen übergeben.

Eine DDE-Überwachungsanwendung sollte nicht versuchen, DDE-Vorgänge (Unterhaltungen einrichten, Transaktionen ausstellen usw.) im Kontext derselben Anwendung instance auszuführen.

Eine synchrone Transaktion schlägt mit einem DMLERR_REENTRANCY Fehler fehl, wenn eine instance derselben Aufgabe bereits eine synchrone Transaktion ausgeführt hat.

Das CBF_FAIL_ALLSVRXACTIONS-Flag bewirkt, dass die DDEML alle Servertransaktionen filtert und durch einen nachfolgenden Aufruf von DdeInitialize geändert werden kann. Das APPCMD_CLIENTONLY-Flag verhindert, dass die DDEML Schlüsselressourcen für den Server erstellt und kann nicht durch einen nachfolgenden Aufruf von DdeInitialize geändert werden.

Es gibt eine ANSI-Version und eine Unicode-Version von DdeInitialize. Die aufgerufene Version bestimmt den Typ der Fensterprozeduren, die zum Steuern von DDE-Unterhaltungen (ANSI oder Unicode) verwendet werden, und den Standardwert für das iCodePage-Element der CONVCONTEXT-Struktur (CP_WINANSI oder CP_WINUNICODE).

Hinweis

Der ddeml.h-Header definiert DdeInitialize als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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

Weitere Informationen

Übersicht über die Dynamic Data Exchange-Verwaltungsbibliothek

Freigeben über