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 code | Description |
|---|---|
|
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 |
|
|
Library |
|
|
DLL |
|
See also
- Access Control Overview
- Basic Access Control Functions
- SECURITY_DESCRIPTOR
- SetSecurityDescriptorRMControl