次の方法で共有


DdeConnectList 関数 (ddeml.h)

指定したサービス名とトピック名のペアをサポートするすべてのサーバー アプリケーションとの会話を確立します。 アプリケーションでは、この関数を使用して、関数に既存の会話ハンドルを渡すことで、会話ハンドルの一覧を取得することもできます。 動的データ交換管理ライブラリは、終了した会話のハンドルを会話リストから削除します。 結果の会話リストには、指定されたサービス名とトピック名をサポートする現在確立されているすべての会話のハンドルが含まれます。

構文

HCONVLIST DdeConnectList(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in]           HCONVLIST    hConvList,
  [in, optional] PCONVCONTEXT pCC
);

パラメーター

[in] idInst

型: DWORD

DdeInitialize 関数の以前の呼び出しによって取得されたアプリケーション インスタンス識別子。

[in] hszService

種類: HSZ

メッセージ交換を確立するサーバー アプリケーションのサービス名を指定する文字列へのハンドル。 このパラメーターが 0L の場合、システムは、指定されたトピック名をサポートするすべての使用可能なサーバーとの会話を確立しようとします。

[in] hszTopic

種類: HSZ

スレッドを確立するトピックの名前を指定する文字列へのハンドル。 このハンドルは、 DdeCreateStringHandle 関数の以前の呼び出しによって作成されている必要があります。 このパラメーターが 0L の場合、システムは、選択したサーバー (またはサーバー) でサポートされているすべてのトピックで会話の確立を試みます。

[in] hConvList

種類: HCONVLIST

列挙する会話リストへのハンドル。 新しい会話リストを確立する場合、このパラメーターは 0L にする必要があります。

[in, optional] pCC

種類: PCONVCONTEXT

会話コンテキスト情報を含む CONVCONTEXT 構造体へのポインター。 このパラメーターが NULL の場合、サーバーは、XTYP_CONNECTまたはXTYP_WILDCONNECTトランザクション中に既定の CONVCONTEXT 構造体受け取ります。

戻り値

種類: HCONVLIST

関数が成功した場合、戻り値は新しい会話リストへのハンドルです。

関数が失敗した場合、戻り値は 0L です。 古い会話リストへのハンドルが無効になっています。

DdeGetLastError 関数を使用してエラー コードを取得できます。エラー コードは、次のいずれかの値になります。

注釈

アプリケーションは、リスト内の会話ハンドルがアクティブかどうかに関係なく、 DdeConnectList 関数によって返されるメッセージ交換リスト ハンドルを解放する必要があります。 ハンドルを解放するために、アプリケーションは DdeDisconnectList を呼び出すことができます。

既定の CONVCONTEXT 構造体のすべてのメンバーは、クライアント アプリケーションによって DdeInitialize 関数の ANSI バージョンと Unicode バージョンのどちらが呼び出されたかに応じて、構造体のサイズを指定し、CP_WINANSI (既定のコード ページ) またはCP_WINUNICODEを指定する iCodePage を除き、0 に設定されます。

要件

要件
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー ddeml.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll

こちらもご覧ください

CONVCONTEXT

概念

DdeConnect

DdeCreateStringHandle

DdeDisconnect

DdeDisconnectList

DdeInitialize

DdeQueryNextServer

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

参照