NetDfsGetFtContainerSecurity function (lmdfs.h)

Article
02/22/2024

Retrieves 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 NetDfsGetFtContainerSecurity(
  [in]  LPWSTR               DomainName,
  [in]  SECURITY_INFORMATION SecurityInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [out] LPDWORD              lpcbSecurityDescriptor
);

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 retrieve.

[out] ppSecurityDescriptor

Pointer to a list SECURITY_DESCRIPTOR structures that contain the security items requested in the SecurityInformation parameter.

Note This buffer must be freed by calling the NetApiBufferFree function.

[out] lpcbSecurityDescriptor

The size of ppSecurityDescriptor, in bytes.

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 retrieved from 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
Target Platform	Windows
Header	lmdfs.h (include LmDfs.h, Lm.h)
Library	Netapi32.lib
DLL	Netapi32.dll