Export (0) Print
Expand All

NetDfsGetFtContainerSecurity function

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

Syntax


NET_API_STATUS NetDfsGetFtContainerSecurity(
  _In_   LPWSTR DomainName,
  _In_   SECURITY_INFORMATION SecurityInformation,
  _Out_  PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  _Out_  LPDWORD lpcbSecurityDescriptor
);

Parameters

DomainName [in]

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

SecurityInformation [in]

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

ppSecurityDescriptor [out]

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.

lpcbSecurityDescriptor [out]

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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008, Windows Server 2003 with SP1

Redistributable

KB 898900 on Windows Server 2003

Header

LmDfs.h (include LmDfs.h or Lm.h)

Library

Netapi32.lib

DLL

Netapi32.dll

See also

Network Management Overview
Network Management Functions
Distributed File System (DFS) Functions

 

 

Show:
© 2014 Microsoft