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

See also

Distributed File System (DFS) Functions

Network Management Functions

Network Management Overview