DdeAccessData-Funktion (ddeml.h)

Artikel
08/23/2023

Ermöglicht den Zugriff auf die Daten im angegebenen DDE-Objekt (Dynamic Data Exchange). Eine Anwendung muss die DdeUnaccessData-Funktion aufrufen, wenn sie den Zugriff auf die Daten im -Objekt abgeschlossen hat.

Syntax

LPBYTE DdeAccessData(
  [in]            HDDEDATA hData,
  [out, optional] LPDWORD  pcbDataSize
);

Parameter

[in] hData

Typ: HDDEDATA

Ein Handle für das DDE-Objekt, auf das zugegriffen werden soll.

[out, optional] pcbDataSize

Typ: LPDWORD

Ein Zeiger auf eine Variable, die die Größe des durch den hData-Parameter identifizierten DDE-Objekts in Bytes empfängt. Wenn dieser Parameter NULL ist, werden keine Größeninformationen zurückgegeben.

Rückgabewert

Typ: LPBYTE

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf das erste Byte von Daten im DDE-Objekt.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

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

Hinweise

Wenn der hData-Parameter nicht an eine DDEML-Funktion (Dynamic Data Exchange Management Library) übergeben wurde, kann eine Anwendung den von DdeAccessData zurückgegebenen Zeiger für Lese-/Schreibzugriff auf das DDE-Objekt verwenden. Wenn hData bereits an eine DDEML-Funktion übergeben wurde, sollte der Zeiger nur für den Lesezugriff auf das Speicherobjekt verwendet werden.

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)
Bibliothek	User32.lib
DLL	User32.dll