NDdeShareEnum 函数

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

检索可用 DDE 共享的列表。

语法

UINT NDdeShareEnum(
  _In_  LPTSTR  lpszServer,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnEntriesRead,
  _Out_ LPDWORD lpcbTotalAvailable
);

参数

lpszServer [in]

DSDM 所在的服务器的名称。

nLevel [in]

保留。 此参数必须为零。

lpBuffer [out]

指向接收 DDE 共享列表的缓冲区的指针。 DDE 共享列表存储为以 null 分隔的字符串序列,结尾处为双 null 字符。 此参数可以为 NULL。 如果 lpBufferNULL,则 DSDM 将返回保存 ltotalAvailable 参数中共享列表所需的缓冲区大小。

cBufSize [in]

lpBuffer 缓冲区的大小(以字节为单位)。 如果 lpBuffer 为 NULL,此参数必须为

lpnEntriesRead [out]

指向一个变量的指针,该变量接收要枚举的共享总数。 此参数不能为 NULL

lpcbTotalAvailable [out]

指向变量的指针,该变量接收缓冲区中存储 DDE 共享列表所需的总字节数。 此参数不能为 NULL

返回值

如果函数成功,则返回值NDDE_NO_ERROR。

如果函数失败,则返回值是错误代码,可以通过调用 NDdeGetErrorString 将其转换为文本错误消息。 如果 lpBuffer 参数为 NULL,则返回NDDE_BUF_TOO_SMALL。

要求

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

Nddeapi.lib
DLL
Nddeapi.dll
Unicode 和 ANSI 名称
NDdeShareEnumW (Unicode) 和 NDdeShareEnumA (ANSI)

另请参阅

网络动态数据交换概述

网络 DDE 函数