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 [仅限桌面应用] |
标头 |
|
库 |
|
DLL |
|
Unicode 和 ANSI 名称 |
NDdeShareGetInfoW (Unicode) 和 NDdeShareGetInfoA (ANSI) |