SetSecurityDescriptorRMControl function

The SetSecurityDescriptorRMControl function sets the resource manager control bits in the SECURITY_DESCRIPTOR structure.

Syntax

C++


DWORD WINAPI SetSecurityDescriptorRMControl(
  _Inout_  PSECURITY_DESCRIPTOR SecurityDescriptor,
  _In_opt_ PUCHAR               RMControl
);

Parameters

SecurityDescriptor [in, out]: A pointer to a SECURITY_DESCRIPTOR structure that contains the resource manager control bits.
RMControl [in, optional]: A pointer to the bitfield value that the resource manager control bits in the SECURITY_DESCRIPTOR structure will be set to. If the value of this parameter is NULL, the resource manager control bits will be cleared.

Return value

The return value is ERROR_SUCCESS.

Remarks

The resource manager control bits are eight bits in the Sbz1 member of the SECURITY_INFORMATION structure that contains information specific to the resource manager accessing the structure. These bits should be accessed only through the GetSecurityDescriptorRMControl and SetSecurityDescriptorRMControl functions.

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Winbase.h (include Windows.h)
Library	Advapi32.lib
DLL	Advapi32.dll