CONVINFO 結構 (ddeml.h)

  • 發行項

包含動態資料 Exchange (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 函數呼叫，則此成員為零。 應用程式不應該將此成員傳遞至 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
 通知應用程式註冊為 APPCMD_MONITOR 正在傳輸 DDE 資料。
XTYP_POKE
0x4090
 要求伺服器接受來自用戶端的未經要求資料。
XTYP_REGISTER
0x80A2
 通知伺服器已註冊服務名稱的其他 DDEML 應用程式。
XTYP_REQUEST
0x20B0
 要求伺服器將資料傳送至用戶端。
XTYP_UNREGISTER
0x80D2
 通知其他 DDEML 應用程式伺服器已取消註冊服務名稱。
XTYP_WILDCONNECT
0x20E2
 要求伺服器與相同的用戶端建立多個交談。
XTYP_XACT_COMPLETE
0x8080
 通知用戶端非同步資料交易已完成。

wStatus

類型： UINT

目前交談的狀態。 這個成員可以是下列一或多個值。

值 意義
ST_ADVISE
0x0002
 一或多個連結正在進行中。
ST_BLOCKED
0x0008
 交談遭到封鎖。
ST_BLOCKNEXT
0x0080
 交談會在呼叫下一個回呼之後封鎖。
ST_CLIENT
0x0010
 傳遞至 DdeQueryConvInfo 函式的 con0x0010versation 控制碼是用戶端控制碼。 如果控制碼為零，則傳遞至 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
 中起始狀態 1。
XST_INIT2
4
 中起始狀態 2。
XST_Null
0
 預先起始狀態。
XST_POKEACKRCVD
8
 剛完成的 Poke 交易。
XST_POKESENT
7
 正在等候通知的 Poke 交易。
XST_REQSENT
5
 要求交易正在等候通知。
XST_UNADVACKRCVD
14
 尚未完成未新增的交易。
XST_UNADVSENT
12
 未新增的交易正在等候通知。

wLastError

類型： UINT

與最後一筆交易相關聯的錯誤值。

hConvList

類型： HCONVLIST

如果目前交談的控制碼位於交談清單中，則為交談清單的控制碼。 如果交談不在交談清單中，則此成員為 Null 。

ConvCtxt

類型： CONVCONTEXT

交談內容。

hwnd

類型： HWND

與交談相關的呼叫應用程式視窗控制碼。

hwndPartner

類型： HWND

與目前交談相關的夥伴應用程式視窗控制碼。

需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
標頭 ddeml.h (包含 Windows.h)

另請參閱

CONVCONTEXT

概念

DdeInitialize

DdePostAdvise

DdeQueryConvInfo

動態資料交換管理程式庫

參考