トランザクションのXTYP_CONNECT

  • [アーティクル]

クライアントは、 XTYP_CONNECT トランザクションを使用して会話を確立します。 DdeConnect 関数の呼び出しでサーバーがサポートするサービス名 (および NULL ではないトピック名) をクライアントが指定すると、動的データ交換 (DDE) サーバー コールバック関数 DdeCallback は、このトランザクションを受け取ります。

#define     XCLASS_BOOL              0x1000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_CONNECT            (0x0060 | XCLASS_BOOL | XTYPF_NOBLOCK)

パラメーター

uType

トランザクションの種類。

uFmt

使用されていません。

hconv

使用されていません。

hsz1

トピック名のハンドル。

hsz2

サービス名のハンドル。

hdata

使用されていません。

dwData1

会話のコンテキスト情報を含む CONVCONTEXT 構造体へのポインター。 クライアントが DDEML アプリケーションでない場合、このパラメーターは 0 です。

dwData2

クライアントがサーバーと同じアプリケーション インスタンスであるかどうかを指定します。 パラメーターが 1 の場合、クライアントは同じインスタンスです。 パラメーターが 0 の場合、クライアントは別のインスタンスです。

戻り値

サーバー コールバック関数は TRUE を 返して、クライアントが指定されたサービス名とトピック名のペアで会話を確立できるようにする必要があります。または、関数は FALSE を 返して会話を拒否する必要があります。 コールバック関数が TRUE を返し、メッセージ交換が正常に確立された場合、システムはサーバーのコールバック関数にXTYP_CONNECT_CONFIRM トランザクションを発行することによって、サーバーにメッセージ交換ハンドルを渡します (サーバーで DdeInitialize 関数で CBF_SKIP_CONNECT_CONFIRMS フラグが指定されていない限り)。

注釈

サーバー アプリケーションが DdeInitialize 関数でCBF_FAIL_CONNECTIONS フラグを指定した場合、このトランザクションはフィルター処理されます。

サーバーはこのトランザクションの種類をブロックできません。 CBR_BLOCK 戻りコードは無視されます。

要件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Ddeml.h (Windows.h を含む)

関連項目

参照

CONVCONTEXT

DdeConnect

DdeInitialize

概念

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