トランザクションの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 [デスクトップ アプリのみ] |
| ヘッダー |
|