CWnd::OnCopyData

このメンバー関数は、フレームワークによって 1 アプリケーション間でデータをコピーします。

afx_msg BOOL OnCopyData(
   CWnd* pWnd,
   COPYDATASTRUCT* pCopyDataStruct 
);

パラメーター

  • pWnd
    データを送信する CWnd オブジェクトへのポインター。

  • pCopyDataStruct
    送信されるデータを含む COPYDATASTRUCT の構造体へのポインター。

戻り値

受信側アプリケーションが正常にデータを受け取る場合 [真] を返します。はを返します FALSE

解説

渡されるデータは、データを受け取るアプリケーションからアクセスできないオブジェクトへのポインターまたはそのほかの参照を含めることはできません。

データはコピーが、送信プロセス内の別のスレッドによって変更しないでください。

受信のアプリケーションは、データを読み取り専用に検討する必要があります。pCopyDataStruct パラメーターが指す構造体は、データのコピー中のみ有効です; ただし、受け取る側のアプリケーションは、構造体に関連付けられているメモリを解放する必要があります。

この関数が返されると受信するアプリケーションがデータへのアクセスが必要な場合は、ローカルのバッファーに受信されたデータをコピーする必要があります。

[!メモ]

このメンバー関数は、アプリケーションが Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。この関数に渡されるパラメーターの値は、フレームワークがメッセージ受信時に受け取ったパラメーターの値に基づいています。この関数の基本クラスの実装を呼び出した場合は、関数に渡したパラメーターではなく、メッセージと共に渡されたパラメーター自体が使用されます。

必要条件

ヘッダー: afxwin.h

参照

関連項目

CWnd クラス

階層図

WM_COPYDATA