DdeAddData 関数 (ddeml.h)
指定した動的データ交換 (DDE) オブジェクトにデータを追加します。 アプリケーションは、オブジェクトの先頭からの任意のオフセットから開始するデータを追加できます。 新しいデータがオブジェクト内の既にデータと重複している場合、新しいデータは、重複が発生したバイト内の古いデータを上書きします。 書き込まれていないオブジェクト内の場所の内容は未定義です。
構文
HDDEDATA DdeAddData(
[in] HDDEDATA hData,
[in] LPBYTE pSrc,
[in] DWORD cb,
[in] DWORD cbOff
);
パラメーター
[in] hData
種類: HDDEDATA
追加データを受け取る DDE オブジェクトのハンドル。
[in] pSrc
種類: LPBYTE
DDE オブジェクトに追加するデータ。
[in] cb
型: DWORD
データが文字列の場合、DDE オブジェクトに追加されるデータの長さ (バイト単位)。
[in] cbOff
型: DWORD
DDE オブジェクトの先頭からのオフセット (バイト単位)。 追加のデータは、このオフセットから始まるオブジェクトにコピーされます。
戻り値
種類: HDDEDATA
関数が成功した場合、戻り値は DDE オブジェクトへの新しいハンドルです。 新しいハンドルは、 オブジェクトへのすべての参照で使用されます。
関数が失敗した場合は、0 を返します。
DdeGetLastError 関数を使用してエラー コードを取得できます。次のいずれかの値を指定できます。
注釈
データ ハンドルが別の 動的データ交換管理ライブラリ 関数のパラメーターとして使用された後、または DDE コールバック関数によって返された後、ハンドルはハンドルによって識別される DDE オブジェクトへの読み取りアクセスにのみ使用できます。
最初に割り当てられたメモリの量が、追加されたデータを保持するために必要な量より少ない場合、 DdeAddData は適切なサイズのグローバル メモリ オブジェクトを再割り当てします。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ddeml.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
関連項目
概念
参照