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

関連項目

概念

DdeAccessData

DdeCreateDataHandle

DdeUnaccessData

動的データ交換管理ライブラリ

参照