NetDfsSetStdContainerSecurity function

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

Syntax

NET_API_STATUS NetDfsSetStdContainerSecurity(
  _In_ LPWSTR               MachineName,
  _In_ SECURITY_INFORMATION SecurityInformation,
  _In_ PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parameters

MachineName [in]

The name of the stand-alone DFS root's host machine. 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 set on the root object.

pSecurityDescriptor [in]

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 for the object specified by the HKLM\Software\Microsoft\Dfs\Standalone key in the registry of the server specified in the MachineName parameter.

Requirements

See also

Network Management Overview

Network Management Functions

Distributed File System (DFS) Functions