DdeConnect

指定されたサービス名とトピック名の組をサポートするサーバアプリケーションとの会話を確立する。複数のそのようなサーバが存在する場合、システムは 1 つだけを選択する。

DdeConnect idInst, hszService, hszTopic, pCC

idInst : [int] 型: DWORD DdeInitialize 関数の以前の呼び出しで取得したアプリケーションインスタンス識別子。
hszService : [intptr] 型: HSZ 会話を確立するサーバアプリケーションのサービス名を指定する文字列へのハンドル。このハンドルは DdeCreateStringHandle 関数の以前の呼び出しで作成されたものでなければならない。0L の場合、利用可能な任意のサーバとの会話が確立される。
hszTopic : [intptr] 型: HSZ 会話を確立するトピックの名前を指定する文字列へのハンドル。このハンドルは DdeCreateStringHandle の以前の呼び出しで作成されたものでなければならない。0L の場合、選択されたサーバがサポートする任意のトピック上で会話が確立される。
pCC : [var] 型: PCONVCONTEXT 会話コンテキスト情報を含む CONVCONTEXT 構造体へのポインタ。NULL の場合、サーバは XTYP_CONNECT または XTYP_WILDCONNECT トランザクション中に既定の CONVCONTEXT 構造体を受け取る。

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

解説

指定されたサービス名とトピック名の組をサポートするサーバアプリケーションとの会話を確立する。複数のそのようなサーバが存在する場合、システムは
1 つだけを選択する。

[戻り値]
型: HCONV 関数が成功した場合、戻り値は確立された会話へのハンドル。関数が失敗した場合、戻り値は 0L。エラーコードは
DdeGetLastError 関数で取得でき、次のいずれかになる:

[備考]
クライアントアプリケーションは選択されたサーバについての仮定をしてはならない。hszService
にインスタンス固有の名前が指定されている場合、指定されたインスタンスとのみ会話が確立される。インスタンス固有のサービス名は
XTYP_REGISTER および XTYP_UNREGISTER トランザクション中にアプリケーションの DDE
コールバック関数に渡される。既定の CONVCONTEXT 構造体のすべてのメンバはゼロに設定されるが、cb
は構造体のサイズを指定し、iCodePage はクライアントアプリケーションが ANSI 版か Unicode 版のいずれの
DdeInitialize 関数を呼んだかに応じて CP_WINANSI (既定コードページ) または CP_WINUNICODE
を指定する。

情報