DdeGetData-Funktion (ddeml.h)

Kopiert Daten aus dem angegebenen DDE-Objekt (Dynamic Data Exchange) in den angegebenen lokalen Puffer.

Syntax

DWORD DdeGetData(
  [in]            HDDEDATA hData,
  [out, optional] LPBYTE   pDst,
  [in]            DWORD    cbMax,
  [in]            DWORD    cbOff
);

Parameter

[in] hData

Typ: HDDEDATA

Ein Handle für das DDE-Objekt, das die zu kopierenden Daten enthält.

[out, optional] pDst

Typ: LPBYTE

Ein Zeiger auf den Puffer, der die Daten empfängt. Wenn dieser Parameter NULL ist, gibt die DdeGetData-Funktion die Datenmenge in Bytes zurück, die in den Puffer kopiert wird.

[in] cbMax

Art: DWORD

Die maximale Datenmenge in Bytes, die in den Puffer kopiert werden soll, auf den der pDst-Parameter verweist. In der Regel gibt dieser Parameter die Länge des Puffers an, auf den pDst verweist.

[in] cbOff

Art: DWORD

Ein Offset innerhalb des DDE-Objekts. Daten werden ab diesem Offset aus dem -Objekt kopiert.

Rückgabewert

Art: DWORD

Wenn der pDst-Parameter auf einen Puffer zeigt, ist der Rückgabewert die Größe des Speicherobjekts in Bytes, das dem Datenhandle zugeordnet ist, oder die größe, die im cbMax-Parameter angegeben ist, je nachdem, was niedriger ist.

Wenn der pDst-ParameterNULL ist, ist der Rückgabewert die Größe des Speicherobjekts in Bytes, das dem Datenhandle zugeordnet ist.

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

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 (Windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll

Siehe auch

Konzept

DdeAccessData

DdeCreateDataHandle

DdeFreeDataHandle

Dynamic Data Exchange Management Library

Referenz