DdeConnectList

指定されたサービス名とトピック名の組をサポートするすべてのサーバアプリケーションとの会話を確立する。

DdeConnectList idInst, hszService, hszTopic, hConvList, pCC

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

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

解説

指定されたサービス名とトピック名の組をサポートするすべてのサーバアプリケーションとの会話を確立する。

[戻り値]
型: HCONVLIST 関数が成功した場合、戻り値は新しい会話リストへのハンドル。関数が失敗した場合、戻り値は
0L。古い会話リストへのハンドルはもう有効ではない。エラーコードは DdeGetLastError 関数で取得でき、次のいずれかになる:

[備考]
アプリケーションは、リスト内の会話ハンドルがアクティブかどうかにかかわらず、DdeConnectList
関数が返す会話リストハンドルを解放しなければならない。ハンドルを解放するにはアプリケーションは DdeDisconnectList
を呼べる。既定の CONVCONTEXT 構造体のすべてのメンバはゼロに設定されるが、cb は構造体のサイズを指定し、iCodePage
はクライアントアプリケーションが ANSI 版か Unicode 版のいずれの DdeInitialize 関数を呼んだかに応じて
CP_WINANSI (既定コードページ) または CP_WINUNICODE を指定する。

情報