トランザクションのXTYP_WILDCONNECT

  • [アーティクル]

クライアントが、指定されたサービス名とトピック名と一致する各サーバーのサービス名とトピック名のペアで会話を確立できるようにします。 DdeConnect または DdeConnectList 関数の呼び出しでクライアントが NULL サービス名、NULL トピック名、またはその両方を指定すると、動的データ交換 (DDE) サーバー コールバック関数 DdeCallback は、このトランザクションを受け取ります。 

#define     XCLASS_DATA              0x2000
#define     XTYPF_NOBLOCK            0x0002
#define     XTYP_WILDCONNECT        (0x00E0 | XCLASS_DATA | XTYPF_NOBLOCK)

パラメーター

uType

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

uFmt

使用されていません。

hconv

使用されていません。

hsz1

トピック名のハンドル。 このパラメーターが NULL の場合、クライアントはサーバーがサポートするすべてのトピック名に関する会話を要求します。

hsz2

サービス名のハンドル。 このパラメーターが NULL の場合、クライアントはサーバーがサポートするすべてのサービス名に対する会話を要求します。

hdata

使用されていません。

dwData1

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

dwData2

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

戻り値

サーバーは、 HSZPAIR 構造体の配列を識別するデータ ハンドルを返す必要があります。 配列には、クライアントによって要求されたサービス名とトピック名のペアと一致するサービス名とトピック名のペアごとに 1 つの構造体が含まれている必要があります。 配列は NULL 文字列ハンドルで終了する必要があります。 システムは XTYP_CONNECT_CONFIRM トランザクションをサーバーに送信して、各会話を確認し、メッセージ交換ハンドルをサーバーに渡します。 DdeInitialize 関数で CBF_SKIP_CONNECT_CONFIRMS フラグを指定した場合、サーバーはこれらの確認を受け取りません。

サーバーは、XTYP_WILDCONNECTトランザクションを拒否するために NULL を返す必要があります。

注釈

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

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

要件

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

関連項目

参照

CONVCONTEXT

DdeConnect

DdeInitialize

HSZPAIR

概念

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