NetDfsSetFtContainerSecurity function (lmdfs.h)

Sets the security descriptor of the container object for the domain-based DFS namespaces in the specified Active Directory domain.

Syntax

NET_API_STATUS NET_API_FUNCTION NetDfsSetFtContainerSecurity(
  [in] LPWSTR               DomainName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parameters

[in] DomainName

Pointer to a string that specifies the Active Directory domain name.

[in] SecurityInformation

SECURITY_INFORMATION structure that contains bit flags that indicate the type of security information to set.

[in] pSecurityDescriptor

Pointer to a SECURITY_DESCRIPTOR structure that contains the security attributes to set as specified in the SecurityInformation parameter.

Return value

If the function succeeds, the return value is NERR_Success.

If the function fails, the return value is a system error code. For a list of error codes, see System Error Codes.

Remarks

The security descriptor is set on the "CN=DFS-Configuration,CN=System,DC=domain" object in Active Directory from the primary domain controller (PDC) of the domain specified in the DomainName parameter, where <domain> is the distinguished name of the domain specified in the DomainName parameter.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008, Windows Server 2008
Target Platform Windows
Header lmdfs.h (include LmDfs.h, Lm.h)
Library Netapi32.lib
DLL Netapi32.dll

See also

Distributed File System (DFS) Functions

Network Management Functions

Network Management Overview