Expand Minimize

GetSecurityDescriptorRMControl function

The GetSecurityDescriptorRMControl function retrieves the resource manager control bits.

Syntax


DWORD WINAPI GetSecurityDescriptorRMControl(
  _In_   PSECURITY_DESCRIPTOR SecurityDescriptor,
  _Out_  PUCHAR RMControl
);

Parameters

SecurityDescriptor [in]

A 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]

A pointer to a buffer that receives the resource manager control bits.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the following value is returned.

Return codeDescription
ERROR_INVALID_DATA

The SE_RM_CONTROL_VALID bit flag is not set in the specified SECURITY_DESCRIPTOR structure.

 

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

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

See also

Access Control Overview
Basic Access Control Functions
SECURITY_DESCRIPTOR
SetSecurityDescriptorRMControl

 

 

Community Additions

ADD
Show:
© 2014 Microsoft