DdeCreateDataHandle-Funktion (ddeml.h)

2023-08-23

Erstellt ein DDE-Objekt (Dynamic Data Exchange) und füllt das Objekt mit Daten aus dem angegebenen Puffer. Eine DDE-Anwendung verwendet diese Funktion bei Transaktionen, bei denen Daten an die Partneranwendung übergeben werden.

Syntax

HDDEDATA DdeCreateDataHandle(
  [in]           DWORD  idInst,
  [in, optional] LPBYTE pSrc,
  [in]           DWORD  cb,
  [in]           DWORD  cbOff,
  [in, optional] HSZ    hszItem,
  [in]           UINT   wFmt,
  [in]           UINT   afCmd
);

Parameter

[in] idInst

Art: DWORD

Die Anwendung instance Bezeichner, der durch einen vorherigen Aufruf der DdeInitialize-Funktion abgerufen wurde.

[in, optional] pSrc

Typ: LPBYTE

Die Daten, die in das DDE-Objekt kopiert werden sollen. Wenn dieser Parameter NULL ist, werden keine Daten in das Objekt kopiert.

[in] cb

Art: DWORD

Die Menge an Arbeitsspeicher in Bytes, die aus dem Puffer kopiert werden soll, auf den pSrc verweist. (Schließen Sie den beendenden NULL-Wert ein, wenn die Daten eine Zeichenfolge sind). Wenn dieser Parameter 0 ist, wird der pSrc-Parameter ignoriert.

[in] cbOff

Art: DWORD

Ein Offset in Bytes vom Anfang des Puffers, auf den der pSrc-Parameter verweist. Die Daten, die bei diesem Offset beginnen, werden aus dem Puffer in das DDE-Objekt kopiert.

[in, optional] hszItem

Typ: HSZ

Ein Handle für die Zeichenfolge, das das Datenelement angibt, das dem DDE-Objekt entspricht. Dieses Handle muss durch einen vorherigen Aufruf der DdeCreateStringHandle-Funktion erstellt worden sein. Wenn das Datenhandle in einer XTYP_EXECUTE Transaktion verwendet werden soll, muss dieser Parameter 0L sein.

[in] wFmt

Typ: UINT

Das Standardformat der Zwischenablage der Daten.

[in] afCmd

Typ: UINT

Die Erstellungsflags. Dieser Parameter kann HDATA_APPOWNED sein, der angibt, dass die Serveranwendung, die die DdeCreateDataHandle-Funktion aufruft, den Von dieser Funktion erstellten Datenhandle besitzt. Dieses Flag ermöglicht es der Anwendung, das Datenhandle mit anderen DDEML-Anwendungen zu teilen, anstatt ein separates Handle zu erstellen, das an jede Anwendung übergeben wird. Wenn dieses Flag angegeben ist, muss die Anwendung das dem Handle zugeordnete Shared Memory-Objekt schließlich mithilfe der DdeFreeDataHandle-Funktion freigeben. Wenn dieses Flag nicht angegeben wird, wird das Handle in der Anwendung ungültig, die das Handle erstellt hat, nachdem das Datenhandle von der DDE-Rückruffunktion der Anwendung zurückgegeben wurde oder als Parameter in einer anderen DDEML-Funktion verwendet wird.

Rückgabewert

Typ: HDDEDATA

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Datenhandle.

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0L.

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

Hinweise

Alle nicht ausgefüllten Speicherorte im DDE-Objekt sind nicht definiert.

Nachdem ein Datenhandle als Parameter in einer anderen DDEML-Funktion verwendet oder von einer DDE-Rückruffunktion zurückgegeben wurde, kann das Handle nur für den Lesezugriff auf das vom Handle identifizierte DDE-Objekt 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