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