CONVINFO 構造体 (ddeml.h)
動的データ交換 (DDE) 会話に関する情報が含まれます。
構文
typedef struct tagCONVINFO {
DWORD cb;
DWORD_PTR hUser;
HCONV hConvPartner;
HSZ hszSvcPartner;
HSZ hszServiceReq;
HSZ hszTopic;
HSZ hszItem;
UINT wFmt;
UINT wType;
UINT wStatus;
UINT wConvst;
UINT wLastError;
HCONVLIST hConvList;
CONVCONTEXT ConvCtxt;
HWND hwnd;
HWND hwndPartner;
} CONVINFO, *PCONVINFO;
メンバー
cb
型: DWORD
構造体のサイズ (バイト単位)。
hUser
種類: DWORD_PTR
アプリケーション定義データ。
hConvPartner
種類: HCONV
DDE 会話内のパートナー アプリケーションへのハンドル。 パートナーが ( DdeInitialize 関数を使用して) DDEML 関数呼び出しを行うために自身を登録していない場合、このメンバーは 0 です。 アプリケーションは、 DdeQueryConvInfo を除く DDEML 関数にこのメンバーを渡さないでください。
hszSvcPartner
種類: HSZ
パートナー アプリケーションのサービス名へのハンドル。
hszServiceReq
種類: HSZ
接続を要求されたサーバー アプリケーションのサービス名へのハンドル。
hszTopic
種類: HSZ
要求されたトピックの名前へのハンドル。
hszItem
種類: HSZ
要求されたアイテムの名前へのハンドル。 このメンバーはトランザクション固有です。
wFmt
型: UINT
交換されるデータの形式。 このメンバーはトランザクション固有です。
wType
型: UINT
現在のトランザクションの種類。 このメンバーはトランザクション固有です。次のいずれかの値を指定できます。
| 値 | 意味 |
|---|---|
|
サーバーからのデータが到着したことをクライアントに通知します。 |
|
アドバイス ループ中に、更新されたデータをクライアントに送信するようにサーバーに要求します。 このトランザクションは、サーバーが DdePostAdvise を呼び出したときに発生します。 |
|
クライアントでアドバイズ ループを開始するようにサーバーに要求します。 |
|
アドバイズ ループが停止していることをサーバーに通知します。 |
|
クライアントとの会話を確立するようにサーバーに要求します。 |
|
クライアントとの会話が確立されたことをサーバーに通知します。 |
|
メッセージ交換が終了したことをサーバーに通知します。 |
|
クライアントから送信されたコマンドを実行するようにサーバーに要求します。 |
|
DDE データが送信されていることを APPCMD_MONITOR として登録されたアプリケーションに通知します。 |
|
クライアントから要求されていないデータを受け入れるようにサーバーに要求します。 |
|
サーバーがサービス名を登録したことを他の DDEML アプリケーションに通知します。 |
|
クライアントにデータを送信するようにサーバーに要求します。 |
|
サーバーがサービス名の登録を解除したことを他の DDEML アプリケーションに通知します。 |
|
同じクライアントとの複数の会話を確立するようにサーバーに要求します。 |
|
非同期データ トランザクションが完了したことをクライアントに通知します。 |
wStatus
型: UINT
現在の会話の状態。 このメンバーには、次の値の 1 つ以上を指定できます。
| 値 | 意味 |
|---|---|
|
1 つ以上のリンクが進行中です。 |
|
会話がブロックされます。 |
|
会話は、次のコールバックを呼び出した後にブロックされます。 |
|
DdeQueryConvInfo 関数に渡される con0x0010versation ハンドルは、クライアント側のハンドルです。 ハンドルが 0 の場合、 DdeQueryConvInfo 関数に渡される会話ハンドルはサーバー側のハンドルです。 |
|
会話が接続されています。 |
|
会話は、会話リストのメンバーです。 |
|
会話の両側で DDEML が使用されています。 |
|
会話の両側で DDEML の同じインスタンスが使用されています。 |
|
会話はパートナーによって終了されました。 |
wConvst
型: UINT
会話の状態。 このメンバーには、次のいずれかの値を指定できます。
wLastError
型: UINT
最後のトランザクションに関連付けられたエラー値。
hConvList
型: HCONVLIST
現在の会話のハンドルが会話リスト内にある場合は、会話リストへのハンドル。 会話が会話リストにない場合、このメンバーは NULL です 。
ConvCtxt
型: CONVCONTEXT
会話コンテキスト。
hwnd
型: HWND
会話に関係する呼び出し元アプリケーションのウィンドウへのハンドル。
hwndPartner
型: HWND
現在の会話に関係するパートナー アプリケーションのウィンドウへのハンドル。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| Header | ddeml.h (Windows.h を含む) |
関連項目
概念
参照