NDdeGetShareSecurity 函数
[不再支持网络 DDE。 windows Vista 上存在Nddeapi.dll,但所有函数调用都返回NDDE_NOT_IMPLEMENTED。]
检索与 DDE 共享关联的安全描述符。 这通常是在编辑时完成的。
语法
UINT NDdeGetShareSecurity(
_In_ LPTSTR lpszServer,
_In_ LPTSTR lpszShareName,
_In_ SECURITY_INFORMATION si,
_Out_ PSECURITY_DESCRIPTOR pSD,
_In_ DWORD cbSD,
_Out_ LPDWORD lpcbsdRequired
);
参数
-
lpszServer [in]
-
DSDM 所在的服务器的名称。
-
lpszShareName [in]
-
要从 DSDM 检索其安全描述符的共享的名称。 此参数不能为 NULL。
-
si [in]
-
一个 SECURITY_INFORMATION 值,该值指定要从与共享关联的安全描述符检索的安全信息。
-
pSD [out]
-
指向接收自相对安全描述符 的 SECURITY_DESCRIPTOR 结构的指针。 此参数可以为 NULL。 如果此参数为 NULL,DSDM 将确定所请求的安全信息的大小,并返回 l NDDE_BUF_TOO_SMALL 错误代码中所需的字节数。
-
cbSD [in]
-
pSD 缓冲区的大小。 如果 pSD 为 NULL,此参数必须为 零。
-
ldRequired [out]
-
指向变量的指针,该变量接收检索到的安全描述符的实际大小。 此参数不能为 NULL。
返回值
如果函数成功,则返回值NDDE_NO_ERROR。
如果函数失败,则返回值为错误代码,可通过调用 NDdeGetErrorString 将其转换为文本错误消息。 如果 pSD 参数为 NULL,则返回NDDE_BUF_TOO_SMALL。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 |
Windows 2000 Server [仅限桌面应用] |
标头 |
|
库 |
|
DLL |
|
Unicode 和 ANSI 名称 |
NDdeGetShareSecurityW (Unicode) 和 NDdeGetShareSecurityA (ANSI) |