NetDfsGetStdContainerSecurity function (lmdfs.h)
Retrieves the security descriptor for the container object of the specified stand-alone DFS namespace.
Syntax
NET_API_STATUS NET_API_FUNCTION NetDfsGetStdContainerSecurity(
[in] LPWSTR MachineName,
[in] SECURITY_INFORMATION SecurityInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[out] LPDWORD lpcbSecurityDescriptor
);
Parameters
[in] MachineName
Pointer to a string that specifies the name of the server that hosts the stand-alone DFS namespace.
[in] SecurityInformation
SECURITY_INFORMATION structure that contains bit flags that indicate the type of security information to retrieve.
[out] ppSecurityDescriptor
Pointer to a list of SECURITY_DESCRIPTOR structures that contain the security items requested in the SecurityInformation parameter.
[out] lpcbSecurityDescriptor
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
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 |