NDdeShareGetInfo 函数

  • 项目

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

检索 DDE 共享信息。 这通常是为编辑而完成的。

语法

UINT NDdeShareGetInfo(
  _In_  LPTSTR  lpszServer,
  _In_  LPTSTR  lpszShareName,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnTotalAvailable,
  _In_  LPWORD  lpnItems
);

parameters

lpszServer [in]

DSDM 所在的服务器的名称。

lpszShareName [in]

要从 DSDM 检索其信息的共享名称。 此参数不得为 NULL。

nLevel [in]

信息级别。 此参数必须为 2。

lpBuffer [out]

指向缓冲区的指针，该缓冲区接收其成员指向的 NDDESHAREINFO 结构和关联数据。 此参数可以为 NULL。 如果 lpBuffer 为 NULL，则 DSDM 会计算存储所请求共享信息所需的字节数，并在 lpnTotalAvailable 字段中返回该值以及NDDE_BUF_TOO_SMALL错误。

cBufSize [in]

lpBuffer 缓冲区的大小（以字节为单位）。 如果 lpBuffer 为 NULL，则 cBufSize 应为零。

lpnTotalAvailable [out]

指向变量的指针，该变量接收存储所请求共享信息所需的总字节数。 此参数不能为 NULL。

lpnItems [in]

指向用于检索部分共享信息的项目选择掩码的指针。

返回值

如果函数成功，则返回值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 名称
 NDdeShareGetInfoW (Unicode) 和 NDdeShareGetInfoA (ANSI)

请参阅

网络动态数据交换概述

网络 DDE 函数

NDDESHAREINFO

NDdeShareSetInfo