NDdeGetTrustedShare 函数
[不再支持网络 DDE。 windows Vista 上存在Nddeapi.dll,但所有函数调用都返回NDDE_NOT_IMPLEMENTED。]
检索与服务器用户的受信任共享列表中的 DDE 共享关联的选项。
语法
UINT NDdeGetTrustedShare(
_In_ LPTSTR lpszServer,
_In_ LPTSTR lpszShareName,
_Out_ LPDWORD lpdwTrustOptions,
_Out_ LPDWORD lpdwShareModId0,
_Out_ LPDWORD lpdwShareModId1
);
参数
-
lpszServer [in]
-
DSDM 所在的服务器的名称。
-
lpszShareName [in]
-
正在查询其受信任状态的共享名称。 此参数不能为 NULL。
-
lpdwTrustOptions [out]
-
指向接收信任选项的变量的指针。 此参数不能为 NULL。 以下信任选项可用。
值 含义 - NDDE_CMD_SHOW_MASK
- 0x0000FFFFL
掩码用于获取用于替代 DDE 共享显示状态的值(如果设置了NDDE_TRUST_CMD_SHOW)。 - NDDE_TRUST_CMD_SHOW
- 0x10000000L
替代 DDE 共享 DSDM 中指定的显示状态。 - NDDE_TRUST_SHARE_DEL
- 0x20000000L
删除共享的受信任状态。 - NDDE_TRUST_SHARE_INIT
- 0x40000000L
如果客户端已在用户的上下文中运行,则允许客户端启动该应用程序。 - NDDE_TRUST_SHARE_START
- 0x80000000L
允许在用户的上下文中启动应用程序。 -
lpdwShareModId0 [out]
-
指向接收受信任共享修改标识符第一部分的变量的指针。 此参数不能为 NULL。
-
lpdwShareModId1 [out]
-
指向接收受信任共享修改标识符的第二部分的变量的指针。 此参数不能为 NULL。
返回值
如果函数成功,则返回值NDDE_NO_ERROR。
如果函数失败,则返回值为错误代码,可通过调用 NDdeGetErrorString 将其转换为文本错误消息。
备注
受信任的共享修改标识符反映了最初向 DDE 共享授予受信任状态时 DSDM 中 DDE 共享的版本。 受信任的共享修改标识符主要用于删除过时的受信任共享。 但是,用户不需要删除已过时的受信任共享。 网络 DDE 代理代表用户删除过时的共享。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
标头 |
|
库 |
|
DLL |
|
Unicode 和 ANSI 名称 |
NDdeGetTrustedShareW (Unicode) 和 NDdeGetTrustedShareA (ANSI) |