NetDfsGetFtContainerSecurity 函数 (lmdfs.h)

检索指定 Active Directory 域中基于域的 DFS 命名空间的容器对象的安全描述符。

语法

NET_API_STATUS NET_API_FUNCTION NetDfsGetFtContainerSecurity(
  [in]  LPWSTR               DomainName,
  [in]  SECURITY_INFORMATION SecurityInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [out] LPDWORD              lpcbSecurityDescriptor
);

参数

[in] DomainName

指向指定 Active Directory 域名的字符串的指针。

[in] SecurityInformation

SECURITY_INFORMATION 结构，其中包含指示要检索的安全信息类型的位标志。

[out] ppSecurityDescriptor

指向列表 SECURITY_DESCRIPTOR 包含 SecurityInformation 参数中请求的安全项的结构的指针。

注意必须通过调用 NetApiBufferFree 函数来释放此缓冲区。

[out] lpcbSecurityDescriptor

ppSecurityDescriptor 的大小（以字节为单位）。

返回值

如果函数成功，则返回值 NERR_Success。

如果函数失败，则返回值为系统错误代码。有关错误代码的列表，请参阅系统错误代码。

注解

安全描述符是从 Active Directory 中的“CN=DFS-Configuration，CN=System，DC=domain”对象中从主域控制器 (PDC) DomainName 参数中指定的域检索的，其中 domain 是 DomainName 参数中指定的域的可分辨名称。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	lmdfs.h (包括 LmDfs.h、Lm.h)
Library	Netapi32.lib
DLL	Netapi32.dll