MONCBSTRUCT 是在 Dynamic Data Exchange Management Library(DDEML)中定义的一个结构,用于描述 DDEML 的监视事件(monitoring events)。此结构提供有关 DDE 事务的信息。

以下是 MONCBSTRUCT 结构的定义:
typedef struct tagMONCBSTRUCT {
  UINT   cb;              // 结构体的大小,用于版本控制
  DWORD  dwTime;          // 事件发生的时间
  HANDLE hTask;           // 任务的句柄
  DWORD  dwRet;           // 事件处理的返回值
  UINT   wType;           // 事件类型
  UINT   wFmt;            // 数据格式
  HCONV  hConv;           // 与事件相关的 DDE 会话的句柄
  HSZ    hsz1;            // 字符串句柄1
  HSZ    hsz2;            // 字符串句柄2
  HDDEDATA hData;         // 与事件相关的 DDE 数据的句柄
  ULONG_PTR dwData1;      // 用户定义的数据1
  ULONG_PTR dwData2;      // 用户定义的数据2
  CONVCONTEXT cc;         // 与事件相关的 DDE 会话的上下文信息
  DWORD  cbData;          // 与事件相关的 DDE 数据的大小
  DWORD  Data[8];         // 与事件相关的 DDE 数据
} MONCBSTRUCT, *PMONCBSTRUCT;

各个字段的含义如下:

  •  cb: 结构体的大小,用于版本控制。在使用前,需要将这个字段设置为结构体的大小,可以使用 sizeof(MONCBSTRUCT)。

  •  dwTime: 事件发生的时间。

  •  hTask: 任务的句柄。

  •  dwRet: 事件处理的返回值。

  •  wType: 事件类型,表示 DDE 事件的类型,例如 XTYP_ADVDATA、XTYP_CONNECT 等。

  •  wFmt: 数据格式,表示与事件相关的数据的格式。

  •  hConv: 与事件相关的 DDE 会话的句柄。

  •  hsz1 和 hsz2: 字符串句柄,用于传递与事件相关的字符串。

  •  hData: 与事件相关的 DDE 数据的句柄。

  •  dwData1 和 dwData2: 用户定义的数据,可以用于传递额外的信息。

  •  cc: 与事件相关的 DDE 会话的上下文信息。

  •  cbData: 与事件相关的 DDE 数据的大小。

  •  Data: 与事件相关的 DDE 数据。


这个结构体通常用于在 DDEML 的监视事件回调函数中,提供有关 DDE 事务的详细信息。

以下是一个简单的示例,演示了如何在监视事件的回调函数中使用 MONCBSTRUCT 结构:
#include <Ddeml.h>

// ...

HDDEDATA CALLBACK DdeCallback(
    UINT   uType,
    UINT   uFmt,
    HCONV  hConv,
    HSZ    hsz1,
    HSZ    hsz2,
    HDDEDATA hData,
    ULONG_PTR dwData1,
    ULONG_PTR dwData2
) {
    if (uType == XTYP_MONITOR) {
        MONCBSTRUCT* pMonData = (MONCBSTRUCT*)hData;
        // 处理监视事件信息
        // ...
    }

    // 处理其他 DDE 事件

    return NULL;
}

在实际应用中,你需要根据具体的监视事件的需求,使用 MONCBSTRUCT 结构体中的字段信息。


转载请注明出处:http://www.zyzy.cn/article/detail/26499/Win32 API/Ddeml.h/MONCBSTRUCT