DdeInitializeW

アプリケーションを動的データ交換管理ライブラリ (DDEML) に登録する。アプリケーションは他のすべての DDEML 関数を呼ぶ前にこの関数を呼ばなければならない。(Unicode)

DdeInitializeW pidInst, pfnCallback, afCmd, ulRes

pidInst : [var] 型: LPDWORD アプリケーションインスタンス識別子。初期化時、このパラメータは 0 を指していなければならない。関数が成功した場合、このパラメータはアプリケーションのインスタンス識別子を指す。この値は、必要とする他のすべての DDEML 関数に idInst パラメータとして渡される。アプリケーションが DDEML DLL の複数インスタンスを使用する場合、アプリケーションは各インスタンス用に異なるコールバック関数を提供すべきである。pidInst が 0 以外の値を指している場合、DDEML の再初期化が行われる。この場合、pidInst は有効なアプリケーションインスタンス識別子を指していなければならない。
pfnCallback : [int] 型: PFNCALLBACK アプリケーション定義の DDE コールバック関数へのポインタ。この関数はシステムが送信する DDE トランザクションを処理する。詳細は DdeCallback コールバック関数を参照。
afCmd : [int] 型: DWORD APPCMD_、CBF_、MF_ フラグの集合。APPCMD_ フラグは DdeInitialize に特別な指示を提供する。CBF_ フラグは特定の種類のトランザクションがコールバック関数に到達するのを防ぐフィルタを指定する。MF_ フラグは DDE 監視アプリケーションが監視する DDE アクティビティの種類を指定する。これらのフラグを使うと、コールバック関数への不必要な呼び出しを排除して DDE アプリケーションのパフォーマンスを向上させられる。
ulRes : [int] 型: DWORD 予約されており、0 に設定する必要がある。

(プラグイン / モジュール : user32.dll)

解説

アプリケーションを動的データ交換管理ライブラリ (DDEML) に登録する。アプリケーションは他のすべての DDEML
関数を呼ぶ前にこの関数を呼ばなければならない。(Unicode)

[戻り値]
型: UINT 関数が成功した場合、戻り値は DMLERR_NO_ERROR。関数が失敗した場合、戻り値は次のいずれかの値になる:

[備考]
DDEML の複数のインスタンスを使用するアプリケーションは、インスタンス間で DDEML オブジェクトを渡してはならない。DDE
監視アプリケーションは、同じアプリケーションインスタンスのコンテキスト内で DDE 操作 (会話の確立、トランザクションの発行など)
を行おうとすべきではない。同じタスクのインスタンスで既に同期トランザクションが進行中の場合、同期トランザクションは
DMLERR_REENTRANCY エラーで失敗する。CBF_FAIL_ALLSVRXACTIONS フラグは DDEML
がすべてのサーバトランザクションをフィルタするようにし、後続の DdeInitialize
呼び出しで変更できる。APPCMD_CLIENTONLY フラグは DDEML がサーバ用のキーリソースを作成するのを防ぎ、後続の
DdeInitialize 呼び出しで変更できない。DdeInitialize には ANSI 版と Unicode
版がある。呼ばれる版によって DDE 会話を制御するために使用されるウィンドウプロシージャの種類 (ANSI または Unicode)
と、CONVCONTEXT 構造体の iCodePage メンバの既定値 (CP_WINANSI または CP_WINUNICODE)
が決まる。
> [!NOTE] > ddeml.h ヘッダは DdeInitialize をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づき自動的に ANSI/Unicode
版を選択する。エンコーディング非依存のエイリアスとそうでないコードを混在させると、コンパイル時または実行時のエラーにつながる不一致が生じる可能性がある。詳細は
Conventions for Function Prototypes を参照。

情報