GetSecurityDescriptorRMControl

The GetSecurityDescriptorRMControl function retrieves the resource manager control bits.

DWORD GetSecurityDescriptorRMControl(
  PSECURITY DESCRIPTOR SecurityDescriptor,
  PUCHAR RMControl
);

Parameters

SecurityDescriptor

[in] Pointer to a SECURITY_DESCRIPTOR structure that contains the resource manager control bits. The value of the Control member is set to SE_RM_CONTROL_VALID

RMControl

[out] Pointer to a buffer that receives the resource manger control bits.

Return Values

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the following value is returned.

Remarks

The resource manager control bits are eight bits in the Sbz1 member of the SECURITY_DESCRIPTOR 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

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Advapi32.lib.

See Also

Access Control Overview, Access Control Functions, SECURITY_DESCRIPTOR, SetSecurityDescriptorRMControl