NDDESHAREINFO 结构

[不再支持网络 DDE。 windows Vista 上存在Nddeapi.dll,但所有函数调用都返回NDDE_NOT_IMPLEMENTED。]

包含 NetDDE 共享数据库管理器 (DSDM) 维护的 DDE 共享属性。 与每个 DDE 共享关联的安全描述符不是通过此结构传递的,而是通过特定函数访问的。 NetDDE DSDM API 接受设置函数的此结构;对于 get 函数,DSDM 返回打包到提供的缓冲区中的结构,以及 成员 lpszShareNamelpszAppTopicListlpszItemList 引用的数据。

语法

typedef struct _NDDESHAREINFO {
  LONG   lRevision;
  LPTSTR lpszShareName;
  LONG   lShareType;
  LPTSTR lpszAppTopicList;
  LONG   fSharedFlag;
  LONG   fService;
  LONG   fStartAppFlag;
  LONG   nCmdShow;
  LONG   qModifyId[2];
  LONG   cNumItems;
  LPTSTR lpszItemList;
} NDDESHAREINFO, *PNDDESHAREINFO;

成员

lRevision

NDDESHAREINFO 结构的修订级别。 目前,修订级别为 1。

lpszShareName

共享的名称。 此字符串的长度不得超过 MAX_NDDESHARENAME 个字符。

lShareType

一个或多个 DDE 共享类型。 此成员可以是以下受支持的 DDE 共享类型的组合。

共享类型 含义
SHARE_TYPE_NEW
0x02
共享包含 OLE 应用程序/主题对。
SHARE_TYPE_OLD
0x01
共享包含 DDE 应用程序/主题对。
SHARE_TYPE_STATIC
0x04
共享包含静态应用程序/主题对。

lpszAppTopicList

指向缓冲区的指针,该缓冲区包含 DDE、OLE 和静态应用程序/主题对的以 null 结尾的字符串。 缓冲区应采用以下格式:

<DDE application name>|<DDE topic name>\0
<OLE application name>|<OLE topic name>\0
<static application name>|<static topic name>\0\0

fSharedFlag

如果此成员为 FALSE,则 DDE 共享将不允许远程用户使用 DDE 通过它进行通信。 但是,本地用户仍可以通过 DDE 共享进行通信。 如果关联的 DACL 授予访问权限,则始终隐含本地客户端链接。

fService

如果设置了此成员,DDE 共享将不会检查当前用户是否在允许 DDE 通信之前将其设置为受信任。

fStartAppFlag

如果设置了此成员,并且共享受信任以启动应用程序,则 NetDDE 将尝试启动 由 lpszAppTopicList 指定的应用程序(如果它最初无法启动与该应用程序的 DDE 会话)。

nCmdShow

当 NetDDE 启动应用程序以启动 DDE 会话时,此值将通过 WinMain 函数的 nCmdShow 参数发送到应用程序。 它定义要显示的应用程序窗口的首选模式。 仅当 fStartAppFlag 处于活动状态时,此参数才有意义。 在上下文中启动应用程序的已登录用户也可以在将共享提升为受信任状态时替代此选项。 此成员的默认值为 SW_SHOWMAXIMIZED。

qModifyId

一个 8 字节序列号,指示 DDE 共享的修改序列号。 每次通过 NDdeShareSetInfoNDdeSetShareSecurity 调用修改 DDE 共享 时,这些值都会更改。

cNumItems

lpszItemList 中列出的项数。 如果 cNumItems 为零,则 lpszItemList 为空,共享信息和关联的安全描述符适用于关联应用程序服务的所有项。

lpszItemList

指向缓冲区的指针,该缓冲区包含以 null 结尾的字符串,这些字符串指定 DDE 事务中的客户端应用程序可以请求或启动建议循环的项。 如果未列出任何项,则 DDE 共享允许使用任何项。 列表中的项数必须与 cNumItems 计数匹配。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Nddeapi.h

另请参阅

网络动态数据交换概述

网络 DDE 结构

NDdeSetShareSecurity

NDdeShareSetInfo

WinMain