DdeConnect 関数 (ddeml.h)

[アーティクル]
02/26/2024

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

構文

HCONV DdeConnect(
  [in]           DWORD        idInst,
  [in]           HSZ          hszService,
  [in]           HSZ          hszTopic,
  [in, optional] PCONVCONTEXT pCC
);

パラメーター

[in] idInst

型: DWORD

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

[in] hszService

種類: HSZ

メッセージ交換を確立するサーバーアプリケーションのサービス名を指定する文字列へのハンドル。このハンドルは、 DdeCreateStringHandle 関数の以前の呼び出しによって作成されている必要があります。このパラメーターが 0L の場合は、使用可能な任意のサーバーとの会話が確立されます。

[in] hszTopic

種類: HSZ

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

[in, optional] pCC

種類: PCONVCONTEXT

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

戻り値

種類: HCONV

関数が成功した場合、戻り値は確立された会話へのハンドルです。

関数が失敗した場合、戻り値は 0L です。

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

注釈

クライアントアプリケーションは、選択したサーバーに関する想定を行うことができません。 hszService パラメーターにインスタンス固有の名前が指定されている場合、指定されたインスタンスのみで会話が確立されます。インスタンス固有のサービス名は、 XTYP_REGISTER および XTYP_UNREGISTER トランザクション中に、アプリケーションの Dynamic Data Exchange (DDE) コールバック関数に渡されます。

既定の CONVCONTEXT 構造体のすべてのメンバーは、構造体のサイズを指定する cb と、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