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

現在のトランザクションの種類。 このメンバーはトランザクション固有です。次のいずれかの値を指定できます。

値 意味
XTYP_ADVDATA
0x4010
 サーバーからのデータが到着したことをクライアントに通知します。
XTYP_ADVREQ
0x2022
 アドバイス ループ中に、更新されたデータをクライアントに送信するようにサーバーに要求します。 このトランザクションは、サーバーが DdePostAdvise を呼び出したときに発生します。
XTYP_ADVSTART
0x1030
 クライアントでアドバイズ ループを開始するようにサーバーに要求します。
XTYP_ADVSTOP
0x8040
 アドバイズ ループが停止していることをサーバーに通知します。
XTYP_CONNECT
0x1062
 クライアントとの会話を確立するようにサーバーに要求します。
XTYP_CONNECT_CONFIRM
0x8072
 クライアントとの会話が確立されたことをサーバーに通知します。
XTYP_DISCONNECT
0x80C2
 メッセージ交換が終了したことをサーバーに通知します。
XTYP_EXECUTE
0x4050
 クライアントから送信されたコマンドを実行するようにサーバーに要求します。
XTYP_MONITOR
0x80F2
 DDE データが送信されていることを APPCMD_MONITOR として登録されたアプリケーションに通知します。
XTYP_POKE
0x4090
 クライアントから要求されていないデータを受け入れるようにサーバーに要求します。
XTYP_REGISTER
0x80A2
 サーバーがサービス名を登録したことを他の DDEML アプリケーションに通知します。
XTYP_REQUEST
0x20B0
 クライアントにデータを送信するようにサーバーに要求します。
XTYP_UNREGISTER
0x80D2
 サーバーがサービス名の登録を解除したことを他の DDEML アプリケーションに通知します。
XTYP_WILDCONNECT
0x20E2
 同じクライアントとの複数の会話を確立するようにサーバーに要求します。
XTYP_XACT_COMPLETE
0x8080
 非同期データ トランザクションが完了したことをクライアントに通知します。

wStatus

型: UINT

現在の会話の状態。 このメンバーには、次の値の 1 つ以上を指定できます。

値 意味
ST_ADVISE
0x0002
 1 つ以上のリンクが進行中です。
ST_BLOCKED
0x0008
 会話がブロックされます。
ST_BLOCKNEXT
0x0080
 会話は、次のコールバックを呼び出した後にブロックされます。
ST_CLIENT
0x0010
 DdeQueryConvInfo 関数に渡される con0x0010versation ハンドルは、クライアント側のハンドルです。 ハンドルが 0 の場合、 DdeQueryConvInfo 関数に渡される会話ハンドルはサーバー側のハンドルです。
ST_CONNECTED
0x0001
 会話が接続されています。
ST_INLIST
0x0040
 会話は、会話リストのメンバーです。
ST_ISLOCAL
0x0004
 会話の両側で DDEML が使用されています。
ST_ISSELF
0x0100
 会話の両側で DDEML の同じインスタンスが使用されています。
ST_TERMINATED
0x0020
 会話はパートナーによって終了されました。

wConvst

型: UINT

会話の状態。 このメンバーには、次のいずれかの値を指定できます。

値 意味
XST_ADVACKRCVD
13
 アドバイス トランザクションが完了しました。
XST_ADVDATAACKRCVD
16
 アドバイス データ トランザクションが完了しました。
XST_ADVDATASENT
15
 データが送信され、受信確認を待機しています。
XST_ADVSENT
11
 アドバイス トランザクションが受信確認を待機しています。
XST_CONNECTED
2
 会話にアクティブなトランザクションがありません。
XST_DATARCVD
6
 要求されたデータが受信されました。
XST_EXECACKRCVD
10
 実行トランザクションが完了しました。
XST_EXECSENT
9
 実行トランザクションが受信確認を待機しています。
XST_INCOMPLETE
1
 最後のトランザクションが失敗しました。
XST_INIT1
3
 Mid-initiate 状態 1。
XST_INIT2
4
 Mid-initiate 状態 2。
XST_NULL
0
 事前開始状態。
XST_POKEACKRCVD
8
 ポケトランザクションが完了しました。
XST_POKESENT
7
 poke トランザクションが受信確認を待機しています。
XST_REQSENT
5
 要求トランザクションが受信確認を待機しています。
XST_UNADVACKRCVD
14
 unadvise トランザクションが完了しました。
XST_UNADVSENT
12
 unadvise トランザクションが受信確認を待機しています。

wLastError

型: UINT

最後のトランザクションに関連付けられたエラー値。

hConvList

型: HCONVLIST

現在の会話のハンドルが会話リスト内にある場合は、会話リストへのハンドル。 会話が会話リストにない場合、このメンバーは NULL です 。

ConvCtxt

型: CONVCONTEXT

会話コンテキスト。

hwnd

型: HWND

会話に関係する呼び出し元アプリケーションのウィンドウへのハンドル。

hwndPartner

型: HWND

現在の会話に関係するパートナー アプリケーションのウィンドウへのハンドル。

要件

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

関連項目

CONVCONTEXT

概念

DdeInitialize

DdePostAdvise

DdeQueryConvInfo

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

参照