Export (0) Print
Expand All

NetDfsGetStdContainerSecurity function

Retrieves the security descriptor for the container object of the specified stand-alone DFS namespace.

Syntax


NET_API_STATUS NetDfsGetStdContainerSecurity(
  _In_   LPWSTR MachineName,
  _In_   SECURITY_INFORMATION SecurityInformation,
  _Out_  PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  _Out_  LPDWORD lpcbSecurityDescriptor
);

Parameters

MachineName [in]

Pointer to a string that specifies the name of the server that hosts the stand-alone DFS namespace.

SecurityInformation [in]

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

ppSecurityDescriptor [out]

Pointer to a list of 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 the buffer that ppSecurityDescriptor points to, 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 object specified by the HKLM\Software\Microsoft\Dfs\Standalone key in the registry of the server specified in the MachineName 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