DdeConnectList 関数 (ddeml.h)

[アーティクル]
08/23/2023

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

構文

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